Agents
Get Agent Details
Fetch one agent with versions and embedded configuration.
GET
Get Agent Details
Read only
Fetch one agent by its
Recommended. This endpoint is part of the public
/v1 API reference and is the supported path for new integrations. See the migration guide for versioning guidance.id. The request is scoped to the authenticated organization automatically. The response includes the agent’s versions, so this is the endpoint to call when you need the full configuration rather than a list summary.
When to use this
- Before an update: fetch the current configuration and version numbers, then send only the changed fields to Update Agent.
- Config review: confirm which version is published and what prompt, voice, and LLM it uses before routing production calls to it.
- Syncing: mirror agent configuration into your own admin UI or configuration store.
404 Not Found. See Errors for the standard error format.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Agent ID
Example:
"agent_2g7Xy3tY53gRlp"
Response
Agent returned with all versions and embedded agent_functions.
Signed agent ID
Example:
"agent_2g7Xy3tY53gRlp"
Available options:
Single_Prompt_Agent, Conversational_Flow_Agent Available options:
Cascaded, Speech_To_Speech Get Agent Details