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

# List Agents

`GET /v1/agents`

List all agents for the authenticated organization.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- AgentListResponse — Schema for listing agents.
  - `agents` AgentDetail[], required — List of agents
    - `name` string, required — Agent name
    - `description` string, nullable — Agent description
    - `model` string — LLM model to use
    - `systemPrompt` string, nullable — System prompt for the agent
    - `temperature` number, nullable — Temperature for generation
    - `maxContextChunks` integer, nullable — Maximum number of context chunks
    - `status` string, nullable — Agent status
    - `useContext` boolean — Whether to use knowledge base context
    - `knowledge` string, nullable — Knowledge base slug to use
    - `metadata` object, nullable — Additional metadata
    - `deepresearch` boolean, nullable — Whether deep research is enabled
    - `id` string, required — Agent ID
    - `slug` string, required — Agent slug
    - `organizationSlug` string, required — Organization slug
    - `createdAt` string, date-time, required — Creation timestamp
    - `updatedAt` string, date-time, nullable — Last update timestamp
  - `count` integer, required — Total number of agents

## Other responses

- `422` — Validation Error

---

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