Agents

Get agent detail

Changed on
get/agents/{id}

Request

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

Path parameters

idstring uuid required

Agent id

Response

idstring uuid required
clientIdstring uuid required
clientNamestring
clientCompanystring nullable
teamIdstring uuid nullable
teamNamestring nullable
scope'personal' | 'team' required
access'owner' | 'team' required
status'active' | 'completed' | 'paused' | 'provisioning' | 'unresponsive' | 'failed' required
startDatestring date-time
activatedAtstring date-time nullable
endDatestring date-time nullable
lastHeartbeatAtstring date-time nullable
upgradingAtstring date-time nullable
namestring required
imagestring required
directModelIdstring nullable

Raw model id for a direct-provider (BYOK openai/anthropic) agent; null for an OpenRouter-catalogue agent.

modelNamestring 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.

harnessNamestring 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
engineVersionstring nullable
engineRequestedVersionstring nullable
machineLostboolean required
missionstring nullable

The agent's mission (1–3 sentences). Present only when the caller can administer the agent (canManage).

systemPromptstring nullable

The agent's raw instructions. Present only when the caller can administer the agent.

clientContextstring nullable

Per-agent business context. Present only when the caller can administer the agent.

Changes