Skip to main content
GET
List project runs

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

project_reference
string
required
Minimum string length: 1

Query Parameters

task_id
string

Filter by the persisted orchestration task identity in task_id; this is distinct from the execution definition target. Discover agent runs with this persisted task identity across conversations. Matches canonical task metadata or the first enqueue request; results are not task authorization evidence.

Required string length: 1 - 200
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9._:-]*$
limit
integer<int32>
default:20

Maximum number of records in a page, from 1 to 100. Defaults to 20.

Required range: 1 <= x <= 100
cursor
string

Opaque page_info.next cursor; reuse with unchanged filters and ordering. Opaque cursor returned by the previous page. Reuse with unchanged filters and ordering.

Minimum string length: 1
sort_by
enum<string>
default:created_at

Field used to order runs: created_at, status or duration. Defaults to created_at.

Available options:
created_at,
status,
duration
sort_order
enum<string>
default:desc

Sort direction: asc or desc. Defaults to desc.

Available options:
asc,
desc
status
string[]

Filter by status. Repeat the query parameter for multiple values; comma-separated values remain a compatibility alias. Values within this filter use OR; different filters use AND. Run statuses to include. Values within this filter use OR; different filters use AND.

Maximum array length: 32
target_type
enum<string>[]

Filter by execution definition type. Execution definition types to include: agent, task, workflow or legacy eval.

Required array length: 1 - 4 elements
Available options:
agent,
task,
workflow,
eval
trigger_type
enum<string>[]

Filter by trigger_type. Trigger types to include: user, api_key, service_account, system, schedule, webhook, agent, task or workflow.

Required array length: 1 - 9 elements
Available options:
user,
api_key,
service_account,
system,
schedule,
webhook,
agent,
task,
workflow
root_only
enum<string>
default:false

true lists only top-level runs (parent_run_id null). Defaults to false.

Available options:
true,
false
parent_run_id
string<uuid>
target_id
string[]

Filter by execution definition ID.

Maximum array length: 32
trigger_id
string

Filter by trigger_id.

Required string length: 1 - 128

Response

Run page

data
object[]
required
page_info
object
required

Opaque cursor for the next page; null means there are no more results.