Skip to main content

Delete a table

Delete a table, including all of its rows and columns.

DELETE /projects/:projectid/databases/:dbid/tables/:tblid

Authentication​

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

Request​

tblid is the table name. No request body.

Destructive operation

This removes the entire table, not just its rows. Export any data you need and check dependencies before running the request. There is no undo endpoint.

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}/tables/${INTELLECTIBLE_TABLE_ID}"

Response​

204 No Content, with no response body.

The operation does not cascade through dependent database objects. Dependencies may prevent deletion; a missing table can return 404.

See Errors and safe retries for shared failure handling.