Update a button on a database
Changes the button's label, icon, variant, action, bindings, placements, confirmation, visibility formula, enabled flag or order; omitted properties keep their current values. Requires the `databases:write` permission and responds with not-found for an unknown button. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.
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 PATCH "https://example.com/v1/workspaces/string/databases/string/buttons/string" \ -H "Content-Type: application/json" \ -d '{}'{ "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}Reorder a database's buttons
Sets the display order of the buttons. `orderedIds` must list every button on the database exactly once - a partial order is rejected rather than silently reshuffling the buttons it omits. Requires the `databases:write` permission. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.
Delete a button from a database
Removes the button and returns the deleted definition; the action it pointed at is left alone. Requires the `databases:write` permission and responds with not-found for an unknown button. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.