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

# List AI agents

`GET /v1/agents`

## Request

- Base URL: `https://api.revdesk.com`
- URL: `https://api.revdesk.com/v1/agents`
- Auth: HTTP bearer

Returns every AI agent in the caller's active organization — the agents that answer inbound calls and lead outbound jobs. Use an agent's `id` as `agent_id` on POST /v1/calls or POST /v1/room-token.

## Query parameters

- `limit` integer, required
- `cursor` string

## Response `200`

Success

- object
  - `data` object[], required
    - `id` string, uuid, required
    - `name` string, required
    - `enabled` boolean, required
    - `agent_type` 'inbound' | 'outbound' | 'both' | 'unassigned', required
    - `greeting` string, nullable, required
    - `language` string, nullable, required
    - `voice_id` string, nullable, required
    - `business_name` string, nullable, required
    - `business_description` string, nullable, required
    - `phone_number` object, nullable, required
      - `id` number, required
      - `phone_number` string, required
      - `provider` string, required
      - `is_active` boolean, required
    - `created_at` string, required
    - `updated_at` string, required
  - `meta` object, required
    - `cursor` string
    - `page_size` number, required

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict (incl. idempotency conflicts)
- `429`: Rate limited

---

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