Skip to main content
GET
Retrieve complete operational metadata, runtime parameters, voice configuration, task definitions, and current status for an existing agent by its unique identifier.

Authentication

This endpoint requires Bearer token authentication.

Input parameters

The following parameters are required to call this endpoint.
string
required
Unique identifier of the agent. Example: agent_12345 or UUID 550e8400-e29b-41d4-a716-446655440000.
string
required
Bearer token for authentication. Format: Bearer <token>.

Response Fields

string
Unique identifier of the agent.
string
Display name assigned to the voice agent.
string
Operational state of the agent (active, inactive, training).
string
Detailed explanation of the agent’s persona and conversational role.
string
ISO 8601 timestamp when the agent was created.
string
ISO 8601 timestamp when the agent configuration was last modified.
object
Runtime settings governing conversational synthesis:
string[]
List of capability tasks and functions assigned to this agent (e.g. qualify_leads, book_meeting, send_followup_email).


Previous
Create agent
Provision a new conversational Voice AI prompt agent
Next