List a database's buttons
Returns the buttons defined on the database in display order, each with the action it runs, its input bindings, the placements it appears in (record, row, or toolbar), its optional visibility formula and its confirmation prompt. Requires the `databases:read` 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 GET "https://example.com/v1/workspaces/string/databases/string/buttons"{ "data": [ { "id": "string", "workspaceId": "string", "databaseId": "string", "label": "string", "icon": "string", "variant": "primary", "actionId": "string", "bindings": [ { "inputPath": "string", "source": "record_id" } ], "confirmation": { "title": "string", "body": "string", "confirmLabel": "string" }, "placements": [ "record" ], "visibleWhen": "string", "enabled": true, "order": 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}Delete a relation and both of its fields
Removes the relation as a whole - both end fields and every link between records - in one transaction; there is no way to delete a single side. Requires the `databases:write` permission on both databases the relation joins, and responds with not-found when the relation has no end on the database in the path. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.
Add a button to a database
Defines a button that runs a workspace action against a record, with optional argument bindings, a confirmation prompt and a `visibleWhen` formula that decides per record whether it is offered. Requires the `databases:write` permission and rejects a missing label, an action that is not usable in this workspace, or a formula that does not parse. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.