runs

Get run

Retrieve a single run by ID, its live progress, and its available skill details.

get/v1/runs/{id}

Request

  • Base URL: https://api.patricia.app (the document declares no server; this is the origin it was published from)
  • URL: https://api.patricia.app/v1/runs/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Headers

X-Tenant-Idstring nullable

Response

The requested agent run.

idstring uuid required
tenant_idstring uuid required
conversation_idstring uuid nullable
actor_idstring uuid nullable
trigger_code'mention' | 'dm' | 'message' | 'proactive' | 'cron' | 'event' | 'heartbeat' | 'discovery' | 'onboarding' | 'manual' | 'spawn' required
message_excerptstring nullable
status_code'queued' | 'running' | 'waiting_approval' | 'suspended' | 'completed' | 'failed' | 'cancelled' | 'denied_autonomous' required
truncatedboolean
no_resultboolean
silentboolean
modelstring required
input_tokensinteger required
output_tokensinteger required
cache_read_tokensinteger required
cache_write_tokensinteger required
cost_micro_usdinteger required
budget_micro_usdinteger nullable
duration_msinteger nullable
errorstring nullable
started_atstring date-time nullable
completed_atstring date-time nullable
created_atstring date-time required
updated_atstring date-time required
peekable_skill_slugsstring[]

Skill slugs this run loaded that the peek drawer (GET /skill-catalog/{slug}) would serve right now. Gated by the skills:read scope: a caller who holds runs:read but not skills:read always gets an empty list here, even for a run that did load a skill.

models_usedstring[]

The models that served this run's rounds, in the order each first served one. A run the person switched to another model mid-way names both; each round is billed at its own model. Read from the first 1,024 rounds the run records, so a model that first served after that is not listed.

creditsinteger required

Credits fixed when the run finished, with live-rate conversion for runs without a snapshot.

Changes

No recorded changes to this operation across all 1 revision of this API.