---
title: "List computers"
method: GET
path: "/api/v1/agents/{agent}/agent_computers"
---

# List computers

`GET /api/v1/agents/{agent}/agent_computers`

Returns all computers belonging to the authenticated app, ordered by creation
time descending. Pass `agent` to scope the results to a single agent's
computers. When `agent` is omitted, computers for all agents in the app are
returned.

Requires an app-scoped API key. If the specified agent does not exist or does
not belong to the app, the endpoint returns 404.

## Path parameters

- `agent` string, required

## Response `200`

Successful response

- AgentComputerListResponse — A list of agent computers returned by a list query.
  - `data` AgentComputer[], required — Array of agent computer objects matching the query.
    - `agent` string — ID of the agent that owns this computer (`agi_...`). `null` if the computer is not yet assigned to an agent.
    - `app` string — ID of the app this computer belongs to (`dap_...`).
    - `config` object — Provider-specific configuration key-value pairs for the computer. Structure depends on the underlying compute provider.
    - `created_at` string, date-time — When the computer was created (ISO 8601).
    - `error_message` string — Human-readable error description when `status` is `"error"`. `null` otherwise.
    - `id` string, required — Computer ID (`cmp_...`).
    - `last_active_at` string, date-time — When the computer last reported activity or received a command. `null` if the computer has never been active.
    - `lookup_key` string — Unique, stable identifier you assign to this computer within its app. `null` if not set.
    - `metadata` object — Arbitrary key-value metadata you attached to the computer. `null` if none was provided.
    - `name` string — Human-readable display name for the computer. `null` if not set.
    - `region` string — Cloud region where the computer is hosted, e.g. `"us-east-1"`. `null` if not yet assigned.
    - `sprite_url` string — URL of the live screenshot sprite used to render a real-time preview of the computer's screen. `null` when no sprite is available.
    - `status` string — Current lifecycle state of the computer. Common values include `"provisioning"`, `"ready"`, `"error"`, and `"terminated"`.
    - `updated_at` string, date-time — When the computer record was last modified (ISO 8601).

## Other responses

- `401` — Unauthorized
- `403` — Forbidden - app scope required
- `404` — Agent not found

---

[API](https://skmtc.net/archastro/apis/archastro-platform-api.md) · [All operations](https://skmtc.net/archastro/apis/archastro-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/archastro/archastro-platform-api/versions/a8772b442f86/schema)