Executions endpoint

List Executions

GET/execution-runs/

Request body

none

This endpoint does not accept a request body.

Query parameters

kind

Limit execution runs to this run kind.

mode

Limit execution runs to this execution mode.

page

One-based result page.

pageSize

Number of results per page.

status

Limit execution runs to this status.

workflowVersionId

Filter execution runs by saved plan workflow version before pagination and total counting. Supplying this filter selects the paginated response, even without page/pageSize.

cURL

curl --fail-with-body \
  -H "Authorization: Bearer ${AKOFLOW_API_TOKEN}" \
  "${AKOFLOW_API_URL}/execution-runs/"

200 OKapplication/json

Response example unavailable; inspect the returned JSON.

Response shape

Without page, pageSize or workflowVersionId, the response is an array of { "run": ... } items. Supplying any of these parameters returns { "items": [...], "page": number, "pageSize": number, "total": number, "hasNext": boolean, "workflowVersionId": string }. The workflow filter is applied before pagination and total counting; unrelated workflow runs and standalone commands are excluded.

Related guide

See the Executions guide for related tasks and context.