List action executions
The durable executions of enqueued operations, oldest id first unless sorted (created_at is when one was queued, done_at when it was executed). You see an execution when you hold the read scope its operation declares (for example messages:read for messages.send); the list is empty otherwise.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Query Parameters
Section titled “Query Parameters ”Opaque cursor: pass the next_cursor of the previous page back unchanged. With sort it must come from a page with the same sort and order; without sort it is the id of the last record.
Opaque cursor: pass the next_cursor of the previous page back unchanged. With sort it must come from a page with the same sort and order; without sort it is the id of the last record.
Sort by id or created_at or updated_at or done_at. Stored columns need only this list’s read scope; derived fields need the scopes that show them. null sorts as the lowest value: first in asc, last in desc. Ties break on id in the same direction. Newest first: sort=created_at&order=desc; for mail use sort=occurred_at&order=desc. Without sort the list is in ascending id order with UUID cursors. Paging is by keyset, not a snapshot: values can rise between pages (or fall), so a record may repeat in asc or be missed in desc. In descending mail date order, newly arrived mail ahead of the cursor is not seen; backfilled older mail behind it is. A complete walk uses the default order. An incremental walk also uses the default ascending id order. Mail created_at uses a temporary sort over the workspace’s rows; id is indexed and follows capture order. For executions: created_at is queued at, the moment the execution was authorised (for an approved action request that is the approval, the request’s decided_at, “approved at”; for a direct call, the call). done_at is executed at: when it finished, done or failed, and null while queued or claimed, so unfinished executions come first in asc and last in desc. The latest executed: sort=done_at&order=desc; the latest queued: sort=created_at&order=desc. updated_at moves only at creation and at the outcome, never between attempts.
Sort by id or created_at or updated_at or done_at. Stored columns need only this list’s read scope; derived fields need the scopes that show them. null sorts as the lowest value: first in asc, last in desc. Ties break on id in the same direction. Newest first: sort=created_at&order=desc; for mail use sort=occurred_at&order=desc. Without sort the list is in ascending id order with UUID cursors. Paging is by keyset, not a snapshot: values can rise between pages (or fall), so a record may repeat in asc or be missed in desc. In descending mail date order, newly arrived mail ahead of the cursor is not seen; backfilled older mail behind it is. A complete walk uses the default order. An incremental walk also uses the default ascending id order. Mail created_at uses a temporary sort over the workspace’s rows; id is indexed and follows capture order. For executions: created_at is queued at, the moment the execution was authorised (for an approved action request that is the approval, the request’s decided_at, “approved at”; for a direct call, the call). done_at is executed at: when it finished, done or failed, and null while queued or claimed, so unfinished executions come first in asc and last in desc. The latest executed: sort=done_at&order=desc; the latest queued: sort=created_at&order=desc. updated_at moves only at creation and at the outcome, never between attempts.
Sort direction: asc (default) or desc. Needs sort.
Sort direction: asc (default) or desc. Needs sort.
Responses
Section titled “ Responses ”Success
object
object
The enqueued operation this executes, for example messages.send.
Queued (waiting or between attempts), claimed (an attempt is running), done or failed.
The operation’s final arguments, fixed when it was authorised.
object
The approved action request this executes; null for a direct call.
The principal that asked: the proposer for an approved request, the caller for a direct call.
The principal whose authority it runs under: the approver, or the caller for a direct call.
The caller’s key of a direct call; null for an approved request.
What the operation produced; null until done.
Why it failed: reauth_required, permission_missing, anchor_missing, provider_rejected, outcome_unknown, attempts_exhausted or deadline_passed.
The vault’s sentence for the failure; never a provider’s own text.
When a never-attempted execution stops being attempted.
When it was executed: when it finished, done or failed; null while queued or claimed.
When it was queued: the moment it was authorised. For an approved action request that is the approval, equal to the request’s decided_at; for a direct call, the call.
Opaque cursor for the next page, or null at the end. Pass it back as after, with the same sort and order.