Permanently delete a reviewed subtree
Requires record write access and the fingerprint from subtree-impact. Revalidates the reviewed records and structure under the hierarchy lock, then permanently deletes the entire subtree atomically through canonical record deletion. A changed fingerprint fails without deleting records. Set requireTrashed=true for Trash-only deletion; every current target must remain archived before any deletion. Omit it for explicitly reviewed active subtree deletion. Send an Idempotency-Key to replay a successful request.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X DELETE "https://example.com/v1/workspaces/string/databases/string/records/string/subtree" \ -H "Content-Type: application/json" \ -d '{ "fingerprint": "string" }'{ "data": { "id": "string" }}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Preview permanent subtree deletion
Requires record write access. Returns the root and every descendant, including archived records, with a fingerprint for confirmation. Read-only; no records are deleted. Branches above 1000 records must first be reduced through smaller reviewed deletions.
List the database templates of a workspace
Returns the workspace's saved database blueprints ordered by label, each with the manifest of fields and views it will create. Requires `databases:read` in the workspace.