Run the action behind a database button field
Resolves the action configured on a record's button field, maps the field's bindings from that record, and runs it with the record context attached to the input. Requires the `actions:run` permission plus edit access to the bound action; a field that is not a button, an unreadable button configuration, or a disabled action is rejected with a validation error. 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
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/workspaces/string/databases/string/records/string/button-fields/string/run"{ "data": { "id": "string", "actionId": "string", "workspaceId": "string", "status": "started", "startedAt": "string", "completedAt": "string", "error": "string", "result": {}, "input": {}, "stepResults": { "property1": { "stepId": "string", "index": 0, "kind": "string", "status": "pending", "result": {}, "error": "string", "startedAt": "string", "completedAt": "string" }, "property2": { "stepId": "string", "index": 0, "kind": "string", "status": "pending", "result": {}, "error": "string", "startedAt": "string", "completedAt": "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}List an action's recent runs
Returns the action's runs, newest first. Requires the `actions:read` permission plus view access to the action. Pass `limit` to change the page size; it defaults to 30 and is capped at 100.
List the workspace's automations
Returns the automations the caller may view, newest first, each with its compiled trigger and graph; automations whose stored graph no longer compiles are omitted, and webhook paths and secrets are included only for callers who can write automations. Requires the `automations:read` permission in the workspace.