Skip to navigation
Runtype APIAgents

List agent executions

Deprecated

Deprecated: use GET /v1/runs?agentId={id}, the single run list for every agent and flow run, including runs dispatched with storeResults: false that write no row here. This endpoint stays available and unchanged. It reads the control-plane agent_executions table only. List execution history for an agent with cursor pagination. Rows include finalOutput by default; pass view=compact for the lighter projection that omits it and previews long strings. Supports cross-agent subagent drill-down via parentExecutionId or executionId filters.

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

idstringRequired

Query parameters

limitstringOptional
cursorstringOptional
includeCountstringOptional
statusenumOptional
surfaceTypestringOptional
agentSourceenumOptional

Only runs recorded with this agent source; external selects runs ingested from outside Runtype (OTLP / compatibility ingest).

Allowed values:
fromstringOptional
tostringOptional
parentExecutionIdstringOptional
executionIdstringOptional
viewenumOptional

Response representation. full (default) preserves complete values and includes each row’s finalOutput; compact omits finalOutput and shortens every remaining string value longer than 100 characters to a 100-character preview followed by ….

Allowed values:

Response

Paginated list of agent executions
datalist of objects
paginationobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error