Marks a database as deleted and queues its data for deletion. The database will
no longer appear in your Nile dashboard. You will be able to connect to it and
operate on it while it is queued for deletion, but compute costs still apply.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Nile Documentation","colors":{"primary":"#fdb768","light":"#fdb768","dark":"#fdb768"},"logo":{"light":"https://mintcdn.com/nile/SZ6JYQiPYP1_QgSP/images/nilemintlogo.svg?fit=max\u0026auto=format\u0026n=SZ6JYQiPYP1_QgSP\u0026q=85\u0026s=3303eacc9118937fc5b967ee98a24024","dark":"https://mintcdn.com/nile/SZ6JYQiPYP1_QgSP/images/nilemintlogo.svg?fit=max\u0026auto=format\u0026n=SZ6JYQiPYP1_QgSP\u0026q=85\u0026s=3303eacc9118937fc5b967ee98a24024","href":"https://www.thenile.dev"},"favicon":"https://mintcdn.com/nile/CzaL00MoWjPpKNw_/images/favicon.svg?fit=max\u0026auto=format\u0026n=CzaL00MoWjPpKNw_\u0026q=85\u0026s=5c01c6ff6f635b2a4799d56abab1a71a","appearance":{"default":"dark","strict":true},"navbar":{"links":[{"href":"https://discord.com/invite/8UuBB84tTy","label":"Community"}],"primary":{"type":"button","label":"Get Started","href":"https://console.thenile.dev"}},"footer":{"socials":{"x":"https://x.com/niledatabase","github":"https://github.com/niledatabase/niledatabase","linkedin":"https://www.linkedin.com/company/niledatabase","discord":"https://discord.com/invite/8UuBB84tTy"},"links":[{"header":"Resources","items":[{"label":"Blog","href":"https://www.thenile.dev/blog"},{"label":"Pricing","href":"https://www.thenile.dev/pricing"},{"label":"Templates","href":"https://www.thenile.dev/templates"},{"label":"Community","href":"https://www.thenile.dev/community"}]},{"header":"Company","items":[{"label":"Careers","href":"https://www.thenile.dev/about-us"},{"label":"About","href":"https://www.thenile.dev/about-us"}]},{"header":"Support","items":[{"label":"Contact Sales","href":"https://www.thenile.dev/contact-us"},{"label":"Get Help","href":"https://www.thenile.dev/contact-us"},{"label":"FAQ","href":"https://www.thenile.dev/pricing"}]}]},"seo":{"metatags":{"og:image":"https://www.thenile.dev/opengraph/docs.jpg"},"indexing":"navigable"},"integrations":{"ga4":{"measurementId":"G-KE7812B4ZF"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"nile","hasAudioNarration":false,"actualSubdomain":"nile","customDomains":["thenile.dev"],"gitSource":{"type":"github","owner":"niledatabase","repo":"niledatabase","deployBranch":"main","contentDirectory":"www/app/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a9cbf6e7168debd2fad7286","collectionId":"92cf1a7a-4366-49ff-a155-84808e6665bd","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a9cbf6e7168debd2fad7286"},"feedback":{"thumbs":true,"issues":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6a9cbf6e7168debd2fad7286","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"Postgres","count":93},{"language":"default","tag":"Auth","count":68},{"language":"default","tag":"Nile Auth","count":61},{"language":"default","tag":"ManagementAPI","count":40},{"language":"default","tag":"Extensions","count":37},{"language":"default","tag":"Get Started","count":37},{"language":"default","tag":"Auth API","count":33},{"language":"default","tag":"Platform","count":24},{"language":"default","tag":"databases","count":20},{"language":"default","tag":"Usecases","count":18}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/databases/delete-a-database","slug":"/api-reference/databases/delete-a-database","pageMetadata":{"title":"Delete a database","description":"Marks a database as deleted and queues its data for deletion. The database will\nno longer appear in your Nile dashboard. You will be able to connect to it and\noperate on it while it is queued for deletion, but compute costs still apply.\n","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 delete /workspaces/{workspaceSlug}/databases/{databaseName}","href":"/api-reference/databases/delete-a-database","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Marks a database as deleted and queues its data for deletion. The database will\\nno longer appear in your Nile dashboard. You will be able to connect to it and\\noperate on it while it is queued for deletion, but compute costs still apply.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Delete a database","description":"Marks a database as deleted and queues its data for deletion. The database will\nno longer appear in your Nile dashboard. You will be able to connect to it and\noperate on it while it is queued for deletion, but compute costs still apply.\n","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 delete /workspaces/{workspaceSlug}/databases/{databaseName}","href":"/api-reference/databases/delete-a-database","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["databases"],"summary":"Delete a database","description":"Marks a database as deleted and queues its data for deletion. The database will\nno longer appear in your Nile dashboard. You will be able to connect to it and\noperate on it while it is queued for deletion, but compute costs still apply.\n","operationId":"deleteDatabase","parameters":["588f9b84-ca66-4854-8440-d3ac32106a30","6de592f4-4a01-49d3-9846-ee9d32348f19"],"responses":{"200":"8ccae002-31b6-4db5-8dc0-66cf4a9d94d9","401":"4d2dd427-7c47-4afa-9cbd-338005dd297c","403":"61f8f7a7-e125-453a-91eb-991afc66a22a","404":"20fe8c4d-ac7d-4204-bacd-57f9ed3e3211"},"security":["a7446093-8bbe-404d-9293-6806242623b0"],"method":"delete","type":"path","servers":["8efdcd65-89ab-4c93-9138-0c636b2ca526"],"path":"/workspaces/{workspaceSlug}/databases/{databaseName}","baseUrlOptions":["https://global.thenile.dev"],"title":"Delete a database","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"588f9b84-ca66-4854-8440-d3ac32106a30":{"name":"workspaceSlug","in":"path","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"6de592f4-4a01-49d3-9846-ee9d32348f19":{"name":"databaseName","in":"path","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"8ccae002-31b6-4db5-8dc0-66cf4a9d94d9":{"description":"Database deleted","content":{"application/json":{"schema":{"required":["apiHost","expandable","id","name","region","status","workspace"],"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"name":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"workspace":{"required":["name","slug"],"type":"object","properties":{"name":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"workspace.name","typeLabel":"string"},"slug":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"workspace.slug","typeLabel":"string"},"id":{"type":"string","uniqueKey":"workspace.id","typeLabel":"string"},"stripe_customer_id":{"type":"string","uniqueKey":"workspace.stripe_customer_id","typeLabel":"string"},"created":{"type":"string","format":"date-time","uniqueKey":"workspace.created","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"workspace","typeLabel":"object"},"status":{"type":"string","enum":["PENDING","REQUESTED","BUILT","POOLED","READY"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"region":{"type":"string","enum":["AWS_US_WEST_2","AWS_EU_CENTRAL_1","AZURE_EASTUS"],"isRequired":true,"uniqueKey":"region","typeLabel":"enum\u003cstring>"},"expandable":{"type":"boolean","isRequired":true,"uniqueKey":"expandable","typeLabel":"boolean"},"apiHost":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"apiHost","typeLabel":"string\u003curi>"},"created":{"type":"string","format":"date-time","uniqueKey":"created","typeLabel":"string\u003cdate-time>"},"deleted":{"type":"string","format":"date-time","uniqueKey":"deleted","typeLabel":"string\u003cdate-time>"},"dbHost":{"type":"string","format":"uri","uniqueKey":"dbHost","typeLabel":"string\u003curi>"},"parent":{"required":["id","name"],"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"parent.id","typeLabel":"string"},"name":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"parent.name","typeLabel":"string"}},"uniqueKey":"parent","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","name":"\u003cstring>","workspace":{"name":"\u003cstring>","slug":"\u003cstring>","id":"\u003cstring>","stripe_customer_id":"\u003cstring>","created":"2023-11-07T05:31:56Z"},"status":"PENDING","region":"AWS_US_WEST_2","expandable":true,"apiHost":"\u003cstring>","created":"2023-11-07T05:31:56Z","deleted":"2023-11-07T05:31:56Z","dbHost":"\u003cstring>","parent":{"id":"\u003cstring>","name":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"4d2dd427-7c47-4afa-9cbd-338005dd297c":{"description":"Unauthorized. Credentials were missing or expired.","content":{"application/json":{"schema":{"required":["errorCode","message","statusCode"],"type":"object","properties":{"errorCode":{"type":"string","enum":["internal_error","bad_request","unsupported_operation","forbidden_operation","entity_not_found","duplicate_entity","invalid_credentials","unknown_oidc_provider","unknown_oidc_party","provider_already_exists","provider_config_error","provider_mismatch","provider_update_error","provider_disabled","session_state_missing","session_state_mismatch","oidc_code_missing","tenant_not_found","constraint_violation","sql_exception","db_creation_failure","db_rename_failure","db_status_failure","db_initialization_failure","db_deletion_failure","db_config_missing","unauthorized_workspace_access","email_send_failure","jdbc_exception","oidc_exception","region_mismatch","credential_creation_failure","credential_propagation_failure","unauthorized_client","unsupported_response_type","invalid_request","server_error","access_denied","feature_ineligible","customer_lookup_failure","threshold_exceeded","create_rejected"],"isRequired":true,"uniqueKey":"errorCode","typeLabel":"enum\u003cstring>"},"message":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"statusCode":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer\u003cint32>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errorCode":"internal_error","message":"\u003cstring>","statusCode":123}}},"exampleType":"generated"}},"exampleType":"generated"},"61f8f7a7-e125-453a-91eb-991afc66a22a":{"description":"Forbidden. The credentials provided do not grant access to the requested resource(s).","content":{"application/json":{"schema":{"required":["errorCode","message","statusCode"],"type":"object","properties":{"errorCode":{"type":"string","enum":["internal_error","bad_request","unsupported_operation","forbidden_operation","entity_not_found","duplicate_entity","invalid_credentials","unknown_oidc_provider","unknown_oidc_party","provider_already_exists","provider_config_error","provider_mismatch","provider_update_error","provider_disabled","session_state_missing","session_state_mismatch","oidc_code_missing","tenant_not_found","constraint_violation","sql_exception","db_creation_failure","db_rename_failure","db_status_failure","db_initialization_failure","db_deletion_failure","db_config_missing","unauthorized_workspace_access","email_send_failure","jdbc_exception","oidc_exception","region_mismatch","credential_creation_failure","credential_propagation_failure","unauthorized_client","unsupported_response_type","invalid_request","server_error","access_denied","feature_ineligible","customer_lookup_failure","threshold_exceeded","create_rejected"],"isRequired":true,"uniqueKey":"errorCode","typeLabel":"enum\u003cstring>"},"message":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"statusCode":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer\u003cint32>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errorCode":"internal_error","message":"\u003cstring>","statusCode":123}}},"exampleType":"generated"}},"exampleType":"generated"},"20fe8c4d-ac7d-4204-bacd-57f9ed3e3211":{"description":"Database not found","content":{"application/json":{"schema":{"required":["errorCode","message","statusCode"],"type":"object","properties":{"errorCode":{"type":"string","enum":["internal_error","bad_request","unsupported_operation","forbidden_operation","entity_not_found","duplicate_entity","invalid_credentials","unknown_oidc_provider","unknown_oidc_party","provider_already_exists","provider_config_error","provider_mismatch","provider_update_error","provider_disabled","session_state_missing","session_state_mismatch","oidc_code_missing","tenant_not_found","constraint_violation","sql_exception","db_creation_failure","db_rename_failure","db_status_failure","db_initialization_failure","db_deletion_failure","db_config_missing","unauthorized_workspace_access","email_send_failure","jdbc_exception","oidc_exception","region_mismatch","credential_creation_failure","credential_propagation_failure","unauthorized_client","unsupported_response_type","invalid_request","server_error","access_denied","feature_ineligible","customer_lookup_failure","threshold_exceeded","create_rejected"],"isRequired":true,"uniqueKey":"errorCode","typeLabel":"enum\u003cstring>"},"message":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"statusCode":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer\u003cint32>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errorCode":"internal_error","message":"\u003cstring>","statusCode":123}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"a7446093-8bbe-404d-9293-6806242623b0":{"jwtBearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]}}},"servers":{"8efdcd65-89ab-4c93-9138-0c636b2ca526":{"url":"https://global.thenile.dev"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"jwtBearerAuth","name":"Authorization"}],"title":"jwtBearerAuth"}]},"originalFileLocation":"https://global.thenile.dev/openapi.yaml?v=74222e6"},"subdomain":"nile","siteName":"Nile Documentation","title":"Delete a database - Nile Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-02T16:09:52.626Z","originalFileLocation":"api-reference/databases/delete-a-database.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Marks a database as deleted and queues its data for deletion. The database will no longer appear in your Nile dashboard. You will be able to connect to it and operate on it while it is queued for deletion, but compute costs still apply.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Nile Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/nile/GO7FOq6RcmxStYK0/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/nile/GO7FOq6RcmxStYK0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/nile/GO7FOq6RcmxStYK0/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/nile/GO7FOq6RcmxStYK0/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/nile/GO7FOq6RcmxStYK0/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/nile/GO7FOq6RcmxStYK0/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/nile/GO7FOq6RcmxStYK0/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/nile/GO7FOq6RcmxStYK0/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/nile/GO7FOq6RcmxStYK0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Delete a database - Nile Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Marks a database as deleted and queues its data for deletion. The database will no longer appear in your Nile dashboard. You will be able to connect to it and operate on it while it is queued for deletion, but compute costs still apply.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Nile Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://thenile.dev/docs/api-reference/databases/delete-a-database\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://www.thenile.dev/opengraph/docs.jpg\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Delete a database - Nile Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Marks a database as deleted and queues its data for deletion. The database will no longer appear in your Nile dashboard. You will be able to connect to it and operate on it while it is queued for deletion, but compute costs still apply.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://www.thenile.dev/opengraph/docs.jpg\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/nile/GO7FOq6RcmxStYK0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Nile Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#fdb768\">\u003clink data-mint-head rel=\"canonical\" href=\"https://thenile.dev/docs/api-reference/databases/delete-a-database\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/databases/delete-a-database.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://thenile.dev/#organization\",\"name\":\"Nile Documentation\",\"url\":\"https://thenile.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/nile/SZ6JYQiPYP1_QgSP/images/nilemintlogo.svg?fit=max\u0026auto=format\u0026n=SZ6JYQiPYP1_QgSP\u0026q=85\u0026s=3303eacc9118937fc5b967ee98a24024\"}},{\"@type\":\"WebSite\",\"@id\":\"https://thenile.dev/docs#website\",\"name\":\"Nile Documentation\",\"url\":\"https://thenile.dev/docs\",\"publisher\":{\"@id\":\"https://thenile.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://thenile.dev/docs/api-reference/databases/delete-a-database#webpage\",\"url\":\"https://thenile.dev/docs/api-reference/databases/delete-a-database\",\"name\":\"Delete a database\",\"description\":\"Marks a database as deleted and queues its data for deletion. The database will no longer appear in your Nile dashboard. You will be able to connect to it and operate on it while it is queued for deletion, but compute costs still apply.\",\"dateModified\":\"2026-01-02T16:09:52.626Z\",\"isPartOf\":{\"@id\":\"https://thenile.dev/docs#website\"},\"breadcrumb\":{\"@id\":\"https://thenile.dev/docs/api-reference/databases/delete-a-database#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://thenile.dev/docs/api-reference/databases/delete-a-database#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"databases\",\"item\":\"https://thenile.dev/docs/api-reference/databases/list-dedicated-compute-instances-for-a-database\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Delete a database\",\"item\":\"https://thenile.dev/docs/api-reference/databases/delete-a-database\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://thenile.dev/docs/api-reference/databases/delete-a-database#apireference\",\"headline\":\"Delete a database\",\"name\":\"Delete a database\",\"description\":\"Marks a database as deleted and queues its data for deletion. The database will no longer appear in your Nile dashboard. You will be able to connect to it and operate on it while it is queued for deletion, but compute costs still apply.\",\"url\":\"https://thenile.dev/docs/api-reference/databases/delete-a-database\",\"mainEntityOfPage\":{\"@id\":\"https://thenile.dev/docs/api-reference/databases/delete-a-database#webpage\"},\"image\":\"https://www.thenile.dev/opengraph/docs.jpg\",\"dateModified\":\"2026-01-02T16:09:52.626Z\",\"publisher\":{\"@id\":\"https://thenile.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://thenile.dev/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Nile Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Nile Documentation","nav":{"global":null,"tabs":[{"tab":"Postgres","pages":[{"title":"Postgres","href":"/getting-started/getting-started"}]},{"tab":"Auth","pages":[{"title":"Auth","href":"/auth/introduction"}]},{"tab":"AI","pages":[{"title":"AI","href":"/ai-embeddings/introduction"}]},{"tab":"Platform","pages":[{"title":"Platform","href":"/cli/introduction"}]},{"tab":"ManagementAPI","groups":[{"group":"databases","pages":[{"title":"List dedicated compute instances for a database","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/databases/{databaseName}/compute","href":"/api-reference/databases/list-dedicated-compute-instances-for-a-database"},{"title":"Create a dedicated compute instance","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 post /workspaces/{workspaceSlug}/databases/{databaseName}/compute","href":"/api-reference/databases/create-a-dedicated-compute-instance"},{"title":"Describe a dedicated compute instance","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/databases/{databaseName}/compute/{instanceId}","href":"/api-reference/databases/describe-a-dedicated-compute-instance"},{"title":"Update a dedicated compute instance","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 put /workspaces/{workspaceSlug}/databases/{databaseName}/compute/{instanceId}","href":"/api-reference/databases/update-a-dedicated-compute-instance"},{"title":"Delete a dedicated compute instance","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 delete /workspaces/{workspaceSlug}/databases/{databaseName}/compute/{instanceId}","href":"/api-reference/databases/delete-a-dedicated-compute-instance"},{"title":"Lists credentials for a database","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/databases/{databaseName}/credentials","href":"/api-reference/databases/lists-credentials-for-a-database"},{"title":"Create a database credential","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 post /workspaces/{workspaceSlug}/databases/{databaseName}/credentials","href":"/api-reference/databases/create-a-database-credential"},{"title":"Delete a database credential","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 delete /workspaces/{workspaceSlug}/databases/{databaseName}/credentials/{credentialId}","href":"/api-reference/databases/delete-a-database-credential"},{"title":"Rotate a database credential","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 post /workspaces/{workspaceSlug}/databases/{databaseName}/credentials/rotate","href":"/api-reference/databases/rotate-a-database-credential"},{"title":"Claim a database provisioned without auth","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 post /workspaces/{workspaceSlug}/databases/claim","href":"/api-reference/databases/claim-a-database-provisioned-without-auth"},{"title":"List database error metrics","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/databases/{databaseId}/insights/errors","href":"/api-reference/databases/list-database-error-metrics"},{"title":"List database query performance metrics","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/databases/{databaseId}/insights/query-performance","href":"/api-reference/databases/list-database-query-performance-metrics"},{"title":"List databases","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/databases","href":"/api-reference/databases/list-databases"},{"title":"Create a database","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 post /workspaces/{workspaceSlug}/databases","href":"/api-reference/databases/create-a-database"},{"title":"Get a database","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/databases/{databaseName}","href":"/api-reference/databases/get-a-database"},{"title":"Rename a database","description":"Renames a database in a workspace.\n","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 put /workspaces/{workspaceSlug}/databases/{databaseName}","href":"/api-reference/databases/rename-a-database"},{"title":"Delete a database","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 delete /workspaces/{workspaceSlug}/databases/{databaseName}","href":"/api-reference/databases/delete-a-database"},{"title":"List database uptime metrics","description":"Lists time-weighted database uptime derived from PostgreSQL ready-probe samples.","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/databases/{databaseId}/insights/uptime","href":"/api-reference/databases/list-database-uptime-metrics"},{"title":"Provision a database without authentication","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 post /databases/provision","href":"/api-reference/databases/provision-a-database-without-authentication"},{"title":"List available regions","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/regions","href":"/api-reference/databases/list-available-regions"}]},{"group":"developers","pages":[{"title":"List developer invites","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/invites","href":"/api-reference/developers/list-developer-invites"},{"title":"Invite a developer to a workspace","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 post /workspaces/{workspaceSlug}/invites","href":"/api-reference/developers/invite-a-developer-to-a-workspace"},{"title":"Deletes a previously issued invite","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 delete /workspaces/{workspaceSlug}/invites/{inviteId}","href":"/api-reference/developers/deletes-a-previously-issued-invite"},{"title":"Identify developer details","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /developers/me","href":"/api-reference/developers/identify-developer-details"}]},{"group":"workspaces","pages":[{"title":"Get workspaces metricscompute","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/metrics/compute","href":"/api-reference/workspaces/get-workspaces-metricscompute"},{"title":"List workspaces","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces","href":"/api-reference/workspaces/list-workspaces"},{"title":"Create a workspace","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 post /workspaces","href":"/api-reference/workspaces/create-a-workspace"},{"title":"Get workspaces","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}","href":"/api-reference/workspaces/get-workspaces"},{"title":"Get workspaces compute types","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/compute-types","href":"/api-reference/workspaces/get-workspaces-compute-types"},{"title":"List developers with access to a workspace","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/developers","href":"/api-reference/workspaces/list-developers-with-access-to-a-workspace"},{"title":"Remove a developer from a workspace","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 delete /workspaces/{workspaceSlug}/developers/{developerId}","href":"/api-reference/workspaces/remove-a-developer-from-a-workspace"},{"title":"Get current subscription (from DB)","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/subscription","href":"/api-reference/workspaces/get-current-subscription-from-db"},{"title":"Change level (effective now or at timestamp)","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 put /workspaces/{workspaceSlug}/subscription","href":"/api-reference/workspaces/change-level-effective-now-or-at-timestamp"},{"title":"Start a subscription row","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 post /workspaces/{workspaceSlug}/subscription","href":"/api-reference/workspaces/start-a-subscription-row"},{"title":"Close a subscription row at given time (now if omitted)","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 delete /workspaces/{workspaceSlug}/subscription/{subscriptionId}","href":"/api-reference/workspaces/close-a-subscription-row-at-given-time-now-if-omitted"},{"title":"Ensure workspace billing customer","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 put /workspaces/{workspaceSlug}/billing/customer","href":"/api-reference/workspaces/ensure-workspace-billing-customer"},{"title":"Get workspace billing readiness","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/billing/readiness","href":"/api-reference/workspaces/get-workspace-billing-readiness"},{"title":"List subscription history (most-recent first)","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/subscription/history","href":"/api-reference/workspaces/list-subscription-history-most-recent-first"},{"title":"Monthly totals by component, from rated lines","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 get /workspaces/{workspaceSlug}/billing/{ym}/totals","href":"/api-reference/workspaces/monthly-totals-by-component-from-rated-lines"}]},{"group":"API Reference","pages":[{"title":"Post oauth2token","deprecated":null,"version":null,"openapi":"https://global.thenile.dev/openapi.yaml?v=74222e6 post /oauth2/token","href":"/api-reference/post-oauth2token"}]}]},{"tab":"Auth API","pages":[{"title":"Auth API","href":"/auth/api-reference/auth/sign-in-to-the-application"}]},{"tab":"Pricing","href":"https://www.thenile.dev/pricing"},{"tab":"Templates","href":"https://www.thenile.dev/templates"},{"tab":"Discord","href":"https://discord.com/invite/8UuBB84tTy"}]},"basePath":"","title":"Delete a database - Nile Documentation","buildId":"dpl_Acry4NrQAgjcikyFgVE2eJ7XQCAv","deploymentId":"dpl_Acry4NrQAgjcikyFgVE2eJ7XQCAv","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C2Ap4tLG.js","utils-DOQ4WuIX.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-PBLA84v6.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BSX8gB2N.js","snippetPresets-DEKVfaPa.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BSZ21_fK.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Bd7Ye-9k.js","shallow-Yd0HfeLO.js","getApiPlaygroundDisplay-CLdBbHLF.js","CodeSnippet-BJnsDPfe.js","CodeSnippets-CdAH7YRl.js","Page-CFXBIa-t.js","getPastedJson-Wsal3Fw6.js","icon-WwS_mnlk.js","MethodPill-CYxxzIKu.js","DuplicateIcon-CejZ8LQc.js","createIcon-DKEFCi_0.js","DynamicMarkdown-BCpKo5ib.js","SectionHeading-ClsMcgQm.js","axios-vUo_bRtp.js","Markdown-BI-KM0cT.js","clsx-Cc5SnnvQ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DOFIgHLg.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-1_MZUC6c.js"]}