Skip to main content
GET
/
workflows
/
{workflow_id}
/
runs
List workflow runs
curl --request GET \
  --url https://api-dev.narrative.io/workflows/{workflow_id}/runs \
  --header 'Authorization: Bearer <token>'
{
  "runs": [
    {
      "run_id": "b7e3f1a2-4c5d-6e7f-8a9b-0c1d2e3f4a5b",
      "status": "completed",
      "start_time": "2025-01-15T10:30:00Z",
      "close_time": "2025-01-15T10:35:00Z"
    }
  ],
  "next_page_token": "eyJsYXN0UnVuSWQiOiJhYmMxMjMifQ=="
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
workflow_id
string<uuid>
required

Unique identifier for a workflow.

Query Parameters

​
per_page
integer
default:10

The maximum number of runs to return per page. Defaults to 10.

Required range: 1 <= x <= 100
​
page_token
string

Opaque token from a previous response to retrieve the next page of results.

Response

A paginated list of workflow runs.

A paginated list of workflow runs.

​
runs
object[]
required

The list of workflow runs.

​
next_page_token
string<byte> | null

Token to retrieve the next page of results, or null if there are no more results.

Example:

"eyJsYXN0UnVuSWQiOiJhYmMxMjMifQ=="