Get a single agent by its Tuner ID.
Returns the agent with its nested integration and provider details. The authenticated user must have access to the workspace the agent belongs to.
GET /workspaces/{workspace_id}/agents or POST /workspaces/{workspace_id}/agents).Use Tuner API key (tr_api_...) or user session token. Find your API key in Workspace Settings > API Keys.
Successful Response
Agent schema for API responses with nested relationships.
Tuner's internal numeric ID for this agent.
ID of the voice provider integration this agent uses.
Display name of the agent.
'inbound' for customer-initiated calls, 'outbound' for agent-initiated calls.
Your voice provider's unique identifier for this agent.
ISO 8601 timestamp when the agent was created.
ISO 8601 timestamp when the agent was last updated.
Brief description of what this agent does.
BCP 47 language tag for the agent's primary language (e.g., 'en', 'es').
System prompt or instructions given to the agent.
Agent workflow configuration. Must be valid JSON.
Name of the voice provider for this agent's integration.
Timestamp when the agent was deleted. Null if the agent is active.
ID of the user who created this agent.
ID of the user who last updated this agent.
Integration schema with nested provider object.