Delete a record
Permanently removes the record along with its description surface and returns the deleted row. Requires the `records:write` permission and responds with not-found when the record is not in the database. Set `archived` through an update instead when the record should stay recoverable.
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
Response Body
application/json
application/json
application/json
curl -X DELETE "https://example.com/v1/workspaces/string/databases/string/records/string"{ "data": { "id": "1d8a44e0-7c93-4f21-b60a-3e8d2f5a9c14", "workspaceId": "4b81aa0c-6d2f-4b19-9f0e-1a7c3d5e8b02", "databaseId": "9f2c1e7a-3b58-4d0c-8e27-6a1f9d4b3c85", "contentSurfaceId": "string", "title": "Ship the desktop app", "data": { "status": "in_progress", "due": "2026-08-01" }, "relations": {}, "computed": {}, "system": {}, "related": {}, "archived": false, "externalId": "string", "createdByUserId": "string", "updatedByUserId": "string", "createdAt": "2026-07-10T08:00:00.000Z", "updatedAt": "2026-07-14T11:26:02.000Z" }}{ "_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}Update a record's values
Applies a partial change to the record's title, cell data or archived flag; keys omitted from `data` keep their current values. Requires the `records:write` permission, and is refused when a value does not fit its field or a blocking validation rule on the database fails.
Ensure a record has a content surface
Returns the page-like description surface attached to the record, creating it on the first call. Responds 201 with `created` true when it minted the surface and 200 when one already existed, so repeated calls are safe. Requires the `records:write` permission.