Skip to main content
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.