---
title: "List your agents"
method: GET
path: "/v1/agents"
---

# List your agents

`GET /v1/agents`

## Request

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

## Query parameters

- `include_independent` boolean

## Response `200`

The authenticated account's agents.

- union[]
  - union: AgentListEntry is returned when include_independent=true; Agent is returned otherwise.
    - Agent
      - `id` string, uuid
      - `user_id` string, uuid
      - `name` string
      - `backend` string
      - `model` string
      - `config` object
      - `entity_disk_id` string
      - `status` string: Warm-session state when known: warming, ready, or sleeping.
      - `deleting` boolean: True while this agent's disk is still being erased. The agent offers no actions except deletion itself, which is idempotent and the only way to finish a stuck one.
      - `deleting_since` string, date-time, nullable: When the erasure was first asked for. Absent when the agent is not being deleted.
      - `moving` boolean: True while this agent's files are being copied to a new disk. Poll the migration progress route only while this is true.
      - `created_at` string, date-time
    - AgentListEntry
      - `id` string, uuid
      - `user_id` string, uuid
      - `name` string
      - `backend` string
      - `model` string
      - `config` object
      - `entity_disk_id` string
      - `status` string: Warm-session state when known: warming, ready, or sleeping.
      - `deleting` boolean: True while this agent's disk is still being erased. The agent offers no actions except deletion itself, which is idempotent and the only way to finish a stuck one.
      - `deleting_since` string, date-time, nullable: When the erasure was first asked for. Absent when the agent is not being deleted.
      - `moving` boolean: True while this agent's files are being copied to a new disk. Poll the migration progress route only while this is true.
      - `created_at` string, date-time
      - `kind` string, required
      - `lifecycle_state` string, required
      - `workspace_storage` boolean, required: True when this agent is the canonical storage agent of a Workspace whose files are in Workspace storage, not in this agent's own volume. Such an agent cannot be selected as a new Workspace manager; a Workspace may retain its current manager.

## Other responses

- `401`: Missing or invalid credential.

---

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