List Workflow runs

List retained runs for this Workflow, newest first. Each run corresponds to one matching Asset event.

GET

/workflows/{workflowId}/runs

Authorization

header

string

required

Enter the project access token with the Bearer prefix, e.g. "Bearer project_access_token"

Query Parameters

limit

default: 100

integer

Limit specifies the maximum number of results to return. Accepts 1 to 100. Defaults to 100.

Required range: 1 <= x <= 100

offset

default: 0

integer

Offset specifies the number of matching results to skip. Must be at least 0. Defaults to 0.

Required range: x >= 0

latest_per_asset

default: false

boolean

LatestPerAsset specifies whether to return only the latest matching run for each Asset. Defaults to false. Pagination and total count apply to Assets when true.

asset_id

string

AssetId specifies the Asset whose results to return. Omit it to include all Assets.

status

string

Status specifies the run status to filter by. Omit it to include all statuses.

Available options:

pendingrunningcompletedfailedcancelled

created.gte

integer

Created at or after this Unix timestamp in seconds.

created.lte

integer

Created at or before this Unix timestamp in seconds.

event_id

string

EventId specifies the triggering event ID to filter by. Omit it to include all events.

Path Parameters

workflowId

string

required

ID of the Workflow.

Responses

application/json

data

object[]

required

Workflow runs in this page.

actions

object

required

Counts of action outcomes in this run. Reused actions are included in completed.

asset_execution_status

string

required

Current run status. pending means its actions have not started; running means work remains. After all actions finish, failed takes precedence over cancelled. Otherwise the run is completed, including when actions were skipped.

Available options:

pendingrunningcompletedfailedcancelled

asset_id

string

required

ID of the Asset processed by this run.

completed_at

object

date-time

required

When the run completed, failed, or was cancelled. Null while the run is pending or running.

created_at

string

date-time

required

When the run was created.

event

string

required

Event specifies the Asset lifecycle event that triggered this run, or manual when the Asset was updated to a newer revision. Action details are available from the run's actions endpoint.

event_id

object

required

EventId specifies the event that triggered this run. Null when the Asset was updated to a newer revision.

string

required

Unique Workflow run ID.

revision

integer

required

Pinned Workflow revision used by this run.

root_run_id

string

required

ID of the first run in this event chain. Equals id when this run starts the chain.

status

string

required

Available options:

pendingrunningcompletedfailedcancelled

updated_at

string

date-time

required

When the run was last updated.

workflow_id

string

required

ID of the Workflow executed by this run.

error

string

Reason the run failed. Omitted when no failure message is available.

limit

integer

required

Maximum number of results requested per page.

offset

integer

required

Number of matching results skipped.

status

"success"

string

required

Status of the API request. Always success for this response.

total

integer

required

Total number of results matching the filters before pagination.

List Workflow runs

application/json

error

object

required

status

"error"

string

required

Status indicates the response status "error"

Validation error

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Authentication error

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Forbidden error

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

NotFound error

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Conflict error

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

TooManyRequests error

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

ServiceUnavailable error

import Chunkify from '@chunkify/chunkify'; const client = new Chunkify({ projectAccessToken: 'My Project Access Token', }); const result = await client.workflows.runs.list('wfl_example', { latest_per_asset: true, }); console.log(result);

from chunkify import Chunkify client = Chunkify( project_access_token="My Project Access Token", ) result = client.workflows.runs.list( "wfl_example", latest_per_asset=True, ) print(result)

<?php use Chunkify\Client; $client = new Client( projectAccessToken: 'My Project Access Token', ); $result = $client->workflows->runs->list( 'wfl_example', latestPerAsset: true, ); var_dump($result);

package main import ( "context" "fmt" "github.com/chunkifydev/chunkify-go" "github.com/chunkifydev/chunkify-go/option" ) func main() { client := chunkify.NewClient( option.WithProjectAccessToken("My Project Access Token"), ) result, err := client.Workflows.Runs.List( context.TODO(), "wfl_example", chunkify.WorkflowRunListParams{ LatestPerAsset: chunkify.Bool(true), }, ) if err != nil { panic(err) } fmt.Printf("%+v\n", result) }

{ "data": [ { "actions": { "cancelled": 0, "completed": 0, "failed": 0, "reused": 0, "skipped": 0, "total": 2 }, "asset_execution_status": "running", "asset_id": "ast_example", "completed_at": null, "created_at": "2026-10-02T10:00:00Z", "event": "asset.ready", "event_id": "evt_example", "id": "wfr_example", "revision": 1, "root_run_id": "wfr_example", "status": "running", "updated_at": "2026-10-02T10:00:00Z", "workflow_id": "wfl_example" } ], "limit": 100, "offset": 0, "status": "success", "total": 1 }