Skip to main content

Delete a database

Delete a database and all of its tables and data.

DELETE /projects/:projectid/databases/:dbid

Authentication​

Send the project API key in the Authorization header, without a Bearer prefix. Requires databases.admin for the database in the URL.

Request​

dbid identifies the database to remove. No request body.

Destructive operation

Check the project and database IDs before running this request. This API has no undo or restore endpoint. Export anything you need and check dependent workflows and applications first.

Example​

Use the environment variables from the database overview. Replace example IDs with your own.

curl --include --request DELETE \
--header "Authorization: ${INTELLECTIBLE_PROJECT_API_KEY}" \
"${INTELLECTIBLE_PUBLIC_API_URL}/projects/${INTELLECTIBLE_PROJECT_ID}/databases/${INTELLECTIBLE_DATABASE_ID}"

Response​

204 No Content, with no response body.

See Errors and safe retries for shared failure handling.