> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AI voice agents

> Select dashboard-managed agents eligible for AI calls through the REST API.

AI voice agents define the conversational behavior used by direct calls and batches. They are configured and managed in the Brightalk dashboard.

## Eligibility

`GET /agents` returns only organization-owned agents currently eligible for outbound AI calling. Eligibility means an agent is active, configured for outbound use, ready to serve calls, and associated with a verified usable outbound route for the organization.

The endpoint accepts either `calls:read` or `batches:read`; its scope mode is `anyOf`. A direct-call integration normally uses `calls:read`, while a batch-only integration can list the same eligible catalog with `batches:read`.

An agent omitted from the list must not be used to create a call or batch. Re-list the catalog instead of caching availability indefinitely.

## Read-only catalog

The REST API exposes a small selection record: `id`, `name`, `description`, `language`, and `availability`. `availability` is `available` for returned entries. Agent definitions cannot be created or changed through this API.

## Select an agent

Use the returned `id` as `agent_id` for `POST /calls` or `POST /batches`. Choose an agent whose configured language and behavior match the recipient. An Automation chooses its own configured agent, so `POST /automation-runs` does not accept `agent_id`.