API ReferenceRuns
List Runs
List recent customer-agent runs for the workspace, newest first.
Optional agent_id filters to one agent. Platform-initiated runs have their own
surface (/api/v1/platform-runs) and never appear here. Capped at 200 entries
per request.
Authorization
HTTPBearer AuthorizationBearer <token>
In: header
Query Parameters
limit?Limit
Default
50agent_id?|null
Header Parameters
X-API-Key?string|null
Response Body
application/json
application/json
curl -X GET "https://api.levainlabs.com/api/v1/runs/"[
{
"id": "string",
"status": "string",
"cost_usd": 0,
"tokens_in": 0,
"tokens_out": 0,
"started_at": "string",
"finished_at": "string",
"error": "string",
"agent_id": "string",
"agent_version_id": "string",
"agent_version": 0,
"parent_run_id": "string",
"session_id": "string",
"user_prompt": "string",
"created_at": "string",
"kind": "agent",
"artifact_count": 0,
"artifact_count_truncated": false
}
]{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}