Move a database group to trash
Archives up to 2,000 specified records and hides their group in the selected view in one transaction. A permission, validation, or missing-record failure rolls back the entire change. Requires records:write and views:write permissions; archived records remain 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
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/workspaces/string/databases/string/trash-group" \ -H "Content-Type: application/json" \ -d '{ "recordIds": [], "viewId": "5aa272a5-73e4-4f9c-8123-4bac998fdb73", "groupKey": "string" }'{ "data": { "id": "string", "workspaceId": "string", "databaseId": "string", "key": "string", "label": "string", "kind": "table", "placement": "database", "manifest": {}, "relationFieldId": "string", "ownerUserId": "string", "scope": "shared", "locked": true, "definitionVersion": 0, "createdAt": "string", "updatedAt": "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}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.
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.