---
title: "Get agent detail"
method: GET
path: "/agents/{id}"
tags: ["Agents"]
---

# Get agent detail

`GET /agents/{id}`

## Request

- Base URL: `https://api.atako.ai`
- URL: `https://api.atako.ai/agents/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Response `200`

- AgentDetail: Single-agent detail, as returned by GET /agents/{id}.
  - `id` string, uuid, required
  - `clientId` string, uuid, required
  - `clientName` string
  - `clientCompany` string, nullable
  - `teamId` string, uuid, nullable
  - `teamName` string, nullable
  - `scope` 'personal' | 'team', required
  - `access` 'owner' | 'team', required
  - `status` 'active' | 'completed' | 'paused' | 'provisioning' | 'unresponsive' | 'failed', required
  - `startDate` string, date-time
  - `activatedAt` string, date-time, nullable
  - `endDate` string, date-time, nullable
  - `lastHeartbeatAt` string, date-time, nullable
  - `upgradingAt` string, date-time, nullable
  - `name` string, required
  - `image` string, required
  - `directModelId` string, nullable: Raw model id for a direct-provider (BYOK openai/anthropic) agent; null for an OpenRouter-catalogue agent.
  - `modelName` string, nullable: Display name of the agent's OpenRouter-catalogue model (ai_models.name); null for a direct-provider agent (see directModelId) or an agent left on the platform default.
  - `harnessName` string, nullable: Display name of the agent's harness (harnesses.name); null when no harness was picked at creation — the runtime `engine` below is then the only harness.
  - `engine` 'openclaw' | 'hermes' | 'opencode', required
  - `engineVersion` string, nullable
  - `engineRequestedVersion` string, nullable
  - `machineLost` boolean, required
  - `activity` ActivitySummary, nullable: In-memory working/idle snapshot for the agent, or null when nothing is tracked yet.
    - `working` boolean, required
    - `labelKey` string
    - `labelParams` object
  - `mission` string, nullable: The agent's mission (1–3 sentences). Present only when the caller can administer the agent (`canManage`).
  - `systemPrompt` string, nullable: The agent's raw instructions. Present only when the caller can administer the agent.
  - `clientContext` string, nullable: Per-agent business context. Present only when the caller can administer the agent.

## Other responses

- `401`: Missing, malformed, or invalid bearer token / API key, or revoked session (SESSION_REVOKED).
- `404`: Not found, or the caller is not authorized to access this resource.

## Changes

- **2026-10-19** `aa555c56fbd7`: 1 warning
  - removed the optional property `checkinModelId` from the response with the `200` status

[Operation history](https://skmtc.dev/atako/apis/atako-api/changes/agents/:id/get.md)

---

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