API ReferenceworkflowsRuns

List Runs

List runs for a workflow.

Tiebreaker is always id ASC so offset/limit pagination is stable when primary sort keys tie. status accepts comma-separated raw RunStatus values; unknown values return 422. search matches the triggering user’s display name (full name, falling back to email).

Authentication

AuthorizationBearer
Clerk JWT token
OR
AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

workflow_idstringRequiredformat: "uuid"

Headers

X-Workspace-Idstring or nullOptional

Query parameters

offsetintegerOptional>=0Defaults to 0
limitintegerOptional1-100Defaults to 20
statusstring or nullOptional

Comma-separated raw RunStatus values (e.g. completed,failed). Values are case-sensitive lowercase. Multiple values OR-match. Empty tokens (e.g. a,,b) and unknown values return 422.

searchstring or nullOptional<=100 characters

Case-insensitive search over triggering user’s display name and email.

sortenumOptionalDefaults to created_at

Sort field: created_at | started_at | completed_at | status.

Allowed values:
orderenumOptionalDefaults to desc
asc or desc.
Allowed values:

Response

Successful Response
datalist of objects
metaobject
paginationobject
PaginationMeta variant for endpoints that compute an unpaginated total.

Errors

422
Unprocessable Entity Error