Get a voice agent or twin by id

GET

/voice/agents/{agent_id}

• Production
• QA

Fetch one agent’s full configuration.

org_id is forwarded as a query param pinned to the caller - voice filters AgentSettings by (org_id, agent_id), so another org’s agent id 404s here exactly like a nonexistent one.

Authorizations

• BearerAuth

Parameters

Path Parameters

agent_id

required

Agent UUID.

string

Agent UUID.

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Responses

200

Successful Response

object

data

required

Envelope for single-agent operations (create / get / update).

object

agent

Any of:

VoiceAgentDetail

Complete agent configuration, as returned by create/get/update.

object

agent_id

required

string

agent_status

required

string

created_at

Any of:

unknown

null

null

created_by_email

Any of:

string

string

null

null

entity_type

required

string

id

required

integer

identity

required

Communication-channel identity for a voice agent (mirrors V2 IdentityV2).

object

avatar_url

Any of:

string

string

null

null

calendar

Any of:

integer

integer

null

null

phone

Any of:

string

string

null

null

voice

Any of:

string

string

null

null

is_template

required

boolean

knowledge

required

Knowledge-collection attachments for a voice agent.

object

collections

Collection IDs (max 4).

Array<string>

org_id

required

string

persona

required

Persona / prompt configuration for a voice agent (mirrors V2 PersonaV2).

object

agent_name

required

Display name of the agent.

string

assertiveness_level

required

0.0=passive, 1.0=assertive.

number

<= 1

company_name_pronunciation

Any of:

string

string

null

null

conciseness_level

required

0.0=verbose, 1.0=brief.

number

<= 1

description

required

Brief summary of the agent’s purpose.

string

formality_level

required

0.0=casual, 1.0=formal.

number

<= 1

inbound_instructions

Any of:

string

string

null

null

outbound_instructions

Any of:

string

string

null

null

outbound_voicemail_prompt

Any of:

string

string

null

null

persona

required

Personality and behavior description.

string

role

required

string

template_id

Any of:

string

string

null

null

updated_at

Any of:

unknown

null

null

use_company_knowledge

required

boolean

null

null

message

Any of:

string

string

null

null

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

notes

Any of:

Array<string>

Array<string>

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

total_available

Any of:

integer

integer

null

null

total_is_lower_bound

Any of:

boolean

boolean

null

null

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string