---
title: "List your agents"
method: GET
path: "/agents"
tags: ["Agents"]
---

# List your agents

`GET /agents`

## Request

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

## Response `200`

Agents you own, plus agents on any team you belong to.

- Agent[]
  - `id` string, uuid, required
  - `clientId` string, uuid, required
  - `teamId` string, uuid, nullable
  - `teamName` string, nullable
  - `scope` 'personal' | 'team', required
  - `access` 'owner' | 'team', required
  - `ownerName` string
  - `status` 'active' | 'completed' | 'paused' | 'provisioning' | 'unresponsive' | 'failed', required
  - `startDate` string, date-time
  - `endDate` string, date-time, nullable
  - `name` string, required
  - `image` string, required: PNG filename under apps/web/public/aiygents/.
  - `engine` 'openclaw' | 'hermes' | 'opencode', required
  - `lastMessage` object, nullable: List-view preview only — content truncated to 280 chars server-side.
    - `role` string
    - `content` string
    - `timestamp` string, date-time
  - `hasUnreadMessages` 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

## Other responses

- `401`: Missing, malformed, or invalid bearer token / API key, or revoked session (SESSION_REVOKED).

---

[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)