Skip to main content
POST
Search AI agent runs

Authorizations

hookie_session
string
cookie
required

The console's sealed session cookie, set by WorkOS AuthKit. Mutating requests also require the X-Requested-With CSRF header.

Path Parameters

pid
string
required

Project id (UUID) belonging to the caller workspace.

Body

application/json

All filters optional and ANDed. Reads the agent_runs table.

model
string
status
string
trigger_id
string
since
string

ISO timestamp; matches created_at >= since.

limit
integer
default:25
Required range: 1 <= x <= 200
offset
integer
default:0
Required range: x >= 0

Response

One page of AI runs, newest first.

entity
string
required
Allowed value: "ai_runs"
count
integer
required
total
integer
required
limit
integer
required
offset
integer
required
results
object[]
required