V2
Delete Database
Move a database to trash and return its soft-delete result.
Delete Database
When to use
Use this endpoint to move a database to trash without permanently deleting its schema or records.
Note: Delete endpoints are intentionally omitted from the machine-readable OpenAPI specification and are not projected to MCP or CLI. This page documents the HTTP endpoint.
Endpoint
| Item | Value |
|---|---|
| Method | DELETE |
| Path | /v2/databases/:database_id |
| Request body | None |
| Response | Soft-deleted database result |
| Scope | databases.write |
database_id must be the UUID of a database the credential can write.
Response
{
"object": "database",
"id": "66666666-6666-4666-8666-666666666666",
"in_trash": true
}
Behavior
- Deletion is soft. The database root is archived; its property schema and records are not physically deleted.
- Database records become unavailable with the root but are not individually rewritten as deleted.
- V2 API does not expose permanent database deletion.
- Repeating the request for a database that is already in trash still succeeds.
Errors
401 unauthorized: token is invalid or expired.403 forbidden: missingdatabases.writeor no write access to the database.404 not_found: database does not exist.