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.
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 POST "https://example.com/v1/workspaces/string/databases/string/records/string/content-surface"{ "data": { "workspaceId": "string", "databaseId": "string", "recordId": "string", "surfaceId": "string", "created": true }}{ "_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}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.
List the comments on a record
Returns the record's comments with each author's display name and avatar. Requires the `records:read` permission on the database.