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

# List All Agents

`GET /agents`

Retrieve a comprehensive list of all agents configured in this OS instance.

**Returns:**
- Agent metadata (ID, name, description)
- Model configuration and capabilities
- Available tools and their configurations
- Session, knowledge, memory, and reasoning settings
- Only meaningful (non-default) configurations are included

## Response `200`

List of agents retrieved successfully

- AgentResponse[]
  - `id` string, nullable
  - `name` string, nullable
  - `db_id` string, nullable
  - `description` string, nullable
  - `role` string, nullable
  - `is_factory` boolean
  - `model` ModelResponse
    - `name` string, nullable — Name of the model
    - `model` string, nullable — Model identifier
    - `provider` string, nullable — Model provider name
  - `tools` object, nullable
  - `sessions` object, nullable
  - `knowledge` object, nullable
  - `memory` object, nullable
  - `reasoning` object, nullable
  - `default_tools` object, nullable
  - `system_message` object, nullable
  - `extra_messages` object, nullable
  - `response_settings` object, nullable
  - `introduction` string, nullable
  - `streaming` object, nullable
  - `metadata` object, nullable
  - `input_schema` object, nullable
  - `factory_input_schema` object, nullable
  - `is_component` boolean
  - `current_version` integer, nullable
  - `stage` string, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/agno/apis/agno-api-reference.md) · [All operations](https://skmtc.net/agno/apis/agno-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agno/agno-api-reference/revisions/5f6149d395d0/schema)