API Reference

List executions

Read-only execution search for an authenticated principal. Results are limited to workflows for which the caller has workflows:<name> entitlement, then filtered by workflow, status, requesting principal, and limit; no execution state is changed.

GET/v1/executions

Read-only execution search for an authenticated principal. Results are limited to workflows for which the caller has workflows: entitlement, then filtered by workflow, status, requesting principal, and limit; no execution state is changed.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

limit?integer

Maximum records to return. Must be between 1 and 100.

Range1 <= value <= 100
Default50
workflow?string

Filter by workflow name.

status?string

Filter by execution status.

principalId?string

Filter by requesting principal.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/executions"
{  "executions": [    {      "cancellationRequestedAt": "string",      "createdAt": "string",      "currentStage": "string",      "executionId": "string",      "finishedAt": "string",      "principalId": "string",      "status": "canceled",      "workflow": "string"    }  ]}

Event catalog GET

Public, read-only catalog of Alfred event types, lifecycle metadata, and JSON Schemas; it requires no bearer token and does not depend on workflow state.

Get execution GET

Reads one execution, its ordered stages, and any normalized onboarding outcome. The bearer principal must hold the workflows:<name> entitlement corresponding to that execution; the operation is valid in every execution state and does not mutate it.