v2

latestOpenAPI 3.1.02026-08-01132728.8 KB

agent_runs

List Agent Runs

Retrieve scheduled or event-triggered agent run outputs.

Results are scoped to the authenticated API key's organization.
Results are sorted by run creation time in descending order (newest first).
List results include output previews; fetch a single run for the full final output.
agent_id and agent_workflow_id are mutually exclusive; supplying both returns a 400.

get/v1/agent-runs/

Query parameters

agent_idstring nullable

Filter to runs from a native scheduled agent ID. Mutually exclusive with agent_workflow_id.

Example:5eb7cf5a86d9755df3a6c593

Filter to runs from a native scheduled agent ID. Mutually exclusive with agent_workflow_id.

agent_workflow_idstring nullable

Filter to runs from a legacy agent workflow ID. Mutually exclusive with agent_id.

Example:5eb7cf5a86d9755df3a6c593

Filter to runs from a legacy agent workflow ID. Mutually exclusive with agent_id.

user_idstring nullable

Filter to runs owned by a user ID.

Example:5eb7cf5a86d9755df3a6c593

Filter to runs owned by a user ID.

call_idstring nullable

Filter to runs associated with a call ID.

Example:5eb7cf5a86d9755df3a6c593

Filter to runs associated with a call ID.

cursorstring nullable

Cursor for pagination

limitinteger

Number of items per page

direction'next' | 'prev'

Pagination direction

Response

Successful Response

Example response

{
  "data": [
    {
      "id": "5eb7cf5a86d9755df3a6c593",
      "agent_id": "5eb7cf5a86d9755df3a6c593",
      "agent_workflow_id": "5eb7cf5a86d9755df3a6c593",
      "user_id": "5eb7cf5a86d9755df3a6c593",
      "call_id": "5eb7cf5a86d9755df3a6c593"
    }
  ]
}