Get a digital twin
GET /voice/twins/{agent_id}
GET
/voice/twins/{agent_id}
A twin is an agent modelled on a specific person.
It shares the agent id space with /voice/agents - a twin IS an agent with
entity_type: "twin" - so the same id works on both. This route returns
the twin-shaped view, including the persona sliders and writing-style
references the agent view does not carry.
Authorizations
Parameters
Path Parameters
agent_id
required
Twin id.
string
Twin id.
Header Parameters
Responses
200
Successful Response
object
data
required
One voice object - a collection, an agent, a route, a chat.
Open-shaped: voice adds fields to these bodies on its own release cadence and a dropped-or-added key must not be a 500 in this service.
object
key
additional properties
any
pagination
Any of:
object
has_next
required
Whether there are more pages
boolean
limit
required
Items per page
integer
notes
Any of:
Array<string>
null
page
required
Current page number (1-indexed)
integer
total
required
Total number of items
integer
null
422
Validation Error
object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string