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.
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
Query Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/workspaces/string/actions/string/runs"{ "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}Run an action
Executes the action's steps with the supplied input and returns the resulting run. Requires the `actions:run` permission plus run access to that action; a disabled action is rejected with a validation error and an unknown id returns not-found. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.
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.