Skip to Content
veriom

Workspace agent runs

GET
/v1/workspaces/{workspace_id}/agent-runs

Authorization

workspaceToken
headerAuthorizationBearer <vat_<opaque-token>>

Expiring, hashed workspace token with explicit scopes.

Path Parameters

workspace_id*Workspace Id
Formatuuid

Query Parameters

audit_id?|null
status?array<string>|

Only runs with these statuses.

limit?Limit
Range1 <= value <= 200
Default50
since?|

Runs started since then; 30 days by default, at most 90.

Response Body

Successful Response

application/json
  1. response

Agent runs as a workspace reads them: what ran and how it went, never what it cost.

Model spend, tokens and cost per agent are Veriom's internal accounting (VER-336): the operator console's fleet view (fleet) reads them, and a workspace reads its consumption as processing units (GET /workspaces/{id}/processing).

has_more?Has More

More runs match than the limit returned, newest first.

Defaultfalse
items*array<>
since?|

Only runs started at or after this time count (queued runs always do): 30 days by default and at most 90, unless one audit's runs are asked for.

totals_by_agent*array<>

Runs per agent over every run that matches the filters.

Example Request
curl -X GET 'https://api.veriom.ai/v1/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/agent-runs'
Example Response
{  "has_more": false,  "items": [    {      "agent_key": "string",      "agent_version": "string",      "attempt": 0,      "audit_id": "78c04fa6-cfb4-46a0-9aa5-3681ba4f3897",      "automatic": true,      "cache_hit": true,      "completed_at": "2019-08-24T14:15:22Z",      "duration_ms": 0,      "error_code": "string",      "fallback_used": true,      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "model_id": "string",      "provider_id": "string",      "started_at": "2019-08-24T14:15:22Z",      "status": "string"    }  ],  "since": "2019-08-24T14:15:22Z",  "totals_by_agent": [    {      "agent_key": "string",      "runs": 0    }  ]}