Delete table

Delete a table and all its data. The deletion is processed asynchronously.

DELETE/api/tables/{table_id}

HTTP referenceScope tables:writeUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

HTTP 200 means deletion was marked and the cascade job admitted; data removal continues asynchronously. Poll the returned operation run. The response sample shows the complete returned fields.

Path parameters

table_idrequired
string
The table ID.

Name	Type	Description
table_idrequired	string	The table ID.

Errors

Status	Meaning
401	Authentication required.
403	Access denied.
404	Table not found.
409	Deletion is not allowed in the current lifecycle state.
503	Failed to queue table deletion; deletion marker is reverted.

Example

bash

curl -X DELETE "https://app.autotouch.ai/api/tables/67bd8c39c7d3e80f0a95b560" \
  -H "Authorization: Bearer stk_your_key_id.your_secret"

Response example

json

{
  "deleted": true,
  "task_id": "job-id",
  "job_id": "job-id",
  "operation_run_id": "operation-run-id"
}