---
title: "List Agents"
method: GET
path: "/v1/agent"
tags: ["agent"]
---

# List Agents

`GET /v1/agent`

List all agents the owner of the API key has access to.

## Response `200`

Successful Response

- DeveloperAgentResponseModel[]
  - `avatar_id` string, required — The ID of the avatar to use.
  - `system_prompt` string, required — The system prompt to use.
  - `name` string, nullable — The agent name.
  - `language` string, nullable — The language to use.
  - `greeting` string, nullable — What to say at the start of the session.
  - `max_session_length_minutes` integer, nullable — The maximum session length in minutes.
  - `capabilities` DeveloperAgentCapability[] — The agent capabilities.
  - `id` string, required — The unique identifier (ID) of the agent.

---

[API](https://skmtc.dev/bey-dev/apis/fastapi.md) · [All operations](https://skmtc.dev/bey-dev/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bey-dev/fastapi/revisions/b999e8704c12/schema)