---
title: "Get one run's status"
method: GET
path: "/v1/agents/{agentID}/runs/{runID}"
---

# Get one run's status

`GET /v1/agents/{agentID}/runs/{runID}`

## Request

- Base URL: `https://api.plori.ai`
- URL: `https://api.plori.ai/v1/agents/{agentID}/runs/{runID}`
- Auth: HTTP bearer

## Path parameters

- `agentID` string, uuid, required
- `runID` string, required

## Response `200`

The run.

- Run: Run status and accounting. The run's OUTPUT is not in this DTO. Read it over the session WebSocket or the MCP get_run_result tool.
  - `id` string
  - `agent_id` string, uuid
  - `workspace_id` string, uuid: The Workspace the run belongs to; omitted for runs outside a Workspace.
  - `thread_id` string, uuid
  - `status` string
  - `actor` object: Workspace run list only: the credential that started the run. Absent when none is recorded.
    - `kind` 'key' | 'web'
    - `key_id` string
    - `key_name` string
    - `revoked` boolean
  - `origin` 'user' | 'schedule' | 'background' | 'agent' | 'agent_result'
  - `parent_run_id` string
  - `started_at` string, date-time
  - `ended_at` string, date-time
  - `last_heartbeat_at` string, date-time
  - `cause` 'user_stop' | 'workspace_stop' | 'input_expired' | 'run_superseded' | 'credits_exhausted' | 'task_budget_exhausted' | 'workspace_save_refused' | 'interrupted' | 'stalled' | 'time_limit' | 'vm_capacity_unavailable' | 'backend_error' | 'spawn_failed' | 'workspace_copy_held' | 'account_disk_full' | 'agent_deleted': Machine-readable terminal cause. After time_limit or stalled the saved work continues with a new message; vm_capacity_unavailable means no VM slot became free before the placement wait ended, and the same message can be sent again. task_budget_exhausted appears only on runs that ended before task group token figures stopped limiting model calls.
  - `retryable` boolean
  - `credits` integer, nullable: Amount charged for the run, in micro-USD (µ$), where 1,000,000 µ$ = $1.
  - `tokens` integer, nullable
  - `stop_reason` string

## Other responses

- `401`: Missing or invalid credential.
- `403`: The resource belongs to another account.
- `404`: No such resource.

---

[API](https://skmtc.dev/plori/apis/plori-rest-api.md) · [All operations](https://skmtc.dev/plori/apis/plori-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/plori/apis/plori-rest-api/revisions/15c4f9260dff?raw)