---
title: "Get an agent run"
method: GET
path: "/v1/agents/{agent_id}"
tags: ["public-api"]
---

# Get an agent run

`GET /v1/agents/{agent_id}`

Return an agent run's status and transcript.

Poll every 3 to 10 seconds while ``loop_status`` is ``running``. Runs
commonly take several minutes. For the status values, see the
[Agent lifecycle and polling](/agent-lifecycle) guide.

The response is scoped to the API key: a run that belongs to another
organization or agent returns 404, so a key can't enumerate or inspect
runs it doesn't own.

## Path parameters

- `agent_id` string, uuid, required

## Response `200`

Successful Response

- PublicAgentStatusResponse
  - `agent_id` string, uuid, required
  - `loop_status` 'running' | 'finished' | 'technical_error' | 'terminated', required — `running`: the agent is working, which includes startup. `finished`: the agent is idle; when it ended its turn normally, the output for the last input is complete. `technical_error`: the run hit an internal error. `terminated`: the run was stopped or deleted.
  - `transcript` TranscriptMessage[], required — The inputs the agent accepted and each turn's final output, ordered oldest first. It doesn't include intermediate tool steps. An empty transcript early in a run is normal.
    - `role` 'input_to_agent' | 'output_from_agent', required — `input_to_agent` is an input the agent accepted; `output_from_agent` is a turn's final output.
    - `text` string, required

## Other responses

- `401` — Missing or invalid API key.
- `404` — No run with this ID is visible to the API key. Runs that belong to another organization or agent also return 404, the same as a nonexistent ID.
- `422` — Validation Error
- `502` — The event history lookup failed. Retry with backoff.
- `503` — Event history is temporarily unavailable. Retry with backoff.

---

[API](https://skmtc.dev/goclicks/apis/clicks-agents-api.md) · [All operations](https://skmtc.dev/goclicks/apis/clicks-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goclicks/clicks-agents-api/revisions/48c124d6f633/schema)