Skip to main content
GET
List agent runs
To check a run, filter by its ID in run_ids and read data[0]. Do not add a status filter while you poll. A run in pending_review needs a review by an authorized user at review.review_url; the API cannot approve it. The results, errors and review decision stay available here. skipped means that the agent was paused or archived before the run started. A cancelled run currently ends as error; the meta.cancellation_status of the cancel response shows the outcome.

Authorizations

X-API-Key
string
header
required

Your organization API key. See Authentication.

Path Parameters

agent_id
string
required

ID of the agent.

Minimum string length: 1

Query Parameters

run_ids
string[]

IDs to return, separated by commas. The other filters also apply.

Required array length: 1 - 100 elements
Minimum string length: 1
limit
integer
default:25

Maximum number of records to return.

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

The next_cursor value from the previous page. Keep the other filters unchanged.

status
enum<string>

Run status.

Available options:
in_progress,
pending_review,
success,
error,
skipped

Response

The request succeeded.

data
object[]
required

The records.

has_more
boolean
required

Whether another page is available.

next_cursor
string | null
required

Cursor for the next page, or null on the last page.