Skip to main content
GET
Get an agent by ID

Authorizations

X-API-Key
string
header
required

[Production] API key for production authentication

Path Parameters

id
string
required

The unique identifier for the agent.

Response

OK

agentType
enum<string>

AgentType is the modality the agent was authored for. Always present: an agent stored without one — every agent that predates the field — reads back as "text", because it was authored when chat was the only thing an agent could be.

Available options:
text,
voice
Example:

"voice"

createdAt
integer
createdBy
string
Example:

"507f1f77bcf86cd799439011"

description
string
disabledToolReferenceIds
string[]
guardrails
object
hooks
object
id
string
Example:

"507f1f77bcf86cd799439011"

image
string
imageOptimizedFormat
boolean
instructions
string
knowledge
object
largeLanguageModelReferenceId
string
lastChangedAt
integer
lastChangedBy
string
Example:

"507f1f77bcf86cd799439011"

llmConfig
object
localeReferenceId
string
name
string
organisationId
string
Example:

"507f1f77bcf86cd799439011"

personaReferenceId
string
projectId
string
Example:

"507f1f77bcf86cd799439011"

realtimeVoice
string

RealtimeVoice is the gpt-live-1 voice; absent means the default ("marin").

referenceId
string
role
string
skillReferenceIds
string[]
toolReferenceIds
string[]
voiceLargeLanguageModelReferenceId
string

VoiceLargeLanguageModelReferenceId links a realtime (V2V) LLM for voice sessions. Optional UUID; text turns never use it.

voicePromptTemplate
string

VoicePromptTemplate is the agent's own template; absent means the product default.