Voice agentsAgents
Get the configuration an agent is serving
The configuration this agent answers calls and chats with, already resolved.
Use this, not GET /v1/agent-media/agents/{agentId}, whenever you want a configuration rather than an identity. That route returns the agent row, whose configuration fields mean different things depending on the publishedVersion pointer and may be absent altogether. This route applies the same rule the call path applies and returns one answer: the published version's configuration if the agent has a pointer, the agent's own configuration if it predates versioning, and 404 if it is serving nothing.
Two 404s, told apart by error, because the remedies differ. not_found means no such agent. not_published means the agent exists and has no published version, so publish one.
secrets references appear here as the reference text, never a value — the same as every other route that returns a stored configuration.
Authorization
bearerAuth AuthorizationBearer <token>
A Tandem bearer token. Requests are scoped to the organization the token belongs to; no organization header is required.
In: header
Path Parameters
agentId*string
The agent's unique ID.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/agent-media/agents/string/published-config"{ "config": { "id": "string", "name": "string", "publishedVersion": "string", "appearance": { "hue": 0, "colors": [ { "hue": 0, "saturation": 0, "lightness": -0.2 } ], "scheme": "mono", "shape": "circle", "pattern": "glow", "pupil": "dot", "irisTexture": "fibers", "ringCount": 2, "ringWidth": 1.2, "ticks": 12, "dashLength": 2, "dashGap": 1.5, "rotation": 0, "notches": true, "lid": "round", "texture": "none", "temper": "calm" }, "avatarImageUrl": "http://example.com", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "systemPrompt": "string", "greeting": "string", "interruptable": true, "channels": [ "voice", "chat" ], "slots": { "llm": { "model": "string", "settings": { "maxTokens": 1, "temperature": 0, "reasoning": { "enabled": false, "budgetTokens": 1024 } } }, "stt": { "provider": "string", "settings": { "language": "string" } }, "tts": { "voiceProvider": "string", "settings": { "language": "string", "voiceId": "string", "engine": "string", "polly": { "rate": "string", "volume": "string" }, "elevenlabs": { "speed": 0.7, "stability": 0, "similarityBoost": 0, "style": 0, "useSpeakerBoost": true, "textNormalization": "auto", "pronunciationDictionaries": [ { "id": "string", "versionId": "string" } ] } } }, "additionalVoices": [ { "voiceProvider": "string", "settings": { "language": "string", "voiceId": "string", "engine": "string", "polly": { "rate": "string", "volume": "string" }, "elevenlabs": { "speed": 0.7, "stability": 0, "similarityBoost": 0, "style": 0, "useSpeakerBoost": true, "textNormalization": "auto", "pronunciationDictionaries": [ { "id": "string", "versionId": "string" } ] } } } ] }, "greetingParts": [ { "language": "string", "text": "string" } ], "variables": [], "dispositions": [], "builtinTools": { "transferToExternal": { "enabled": false, "destinations": [] }, "transferToVoiceAgent": { "enabled": false, "contextCarryover": "none", "destinations": [] }, "captureDtmf": { "enabled": false, "maxDigits": 16, "terminator": "#", "timeoutMs": 10000, "interDigitTimeoutMs": 3000, "interruptsSpeech": true }, "recordingControl": { "enabled": false }, "currentTime": { "enabled": false, "timezone": "America/New_York" }, "setWorkflowVariable": { "enabled": false, "variables": [] } }, "dtmf": { "enabled": false, "interDigitGapMs": 1500, "terminator": "#", "maxDigits": 32, "interruptsSpeech": true }, "thinkingCue": { "kind": "none" }, "vad": { "silenceMs": 200, "threshold": 0.7, "startMs": 200, "minVolume": 0.6, "endOfTurnGraceMs": 600, "bargeInMinWords": 1 }, "turnDetection": { "mode": "silence", "smartStopMs": 3000, "preSpeechMs": 500, "maxDurationSecs": 8 }, "memory": { "depth": "none", "customizeGreeting": false }, "safety": { "redactPii": true, "steeringRules": [ "string" ] }, "skills": { "builtins": [], "custom": [] }, "analysis": { "enabled": false, "builtins": { "sentiment": { "enabled": false, "prompt": "string" }, "outcome": { "enabled": false, "prompt": "string" }, "summary": { "enabled": false, "prompt": "string" } }, "fields": [] }, "retention": { "transcripts": true }, "idle": { "enabled": false, "timeoutMs": 10000, "action": "reprompt", "prompt": "string", "maxReprompts": 2, "onExhausted": "endCall", "disposition": "string" }, "limits": { "maxCallDurationMs": 60000, "warnBeforeEndMs": 5000, "warnPrompt": "string" }, "reliability": { "maxConsecutiveTurnFailures": 1, "toolTimeoutMs": 1000, "steeringJudgeTimeoutMs": 500, "handoffMaxHistoryMessages": 1, "modelRetryMaxAttempts": 1, "modelRetryInitialDelayMs": 100, "modelRetryMaxDelayMs": 100 }, "conversation": { "strategy": "slidingWindow", "windowSize": 10, "summaryRatio": 0.1, "preserveRecentMessages": 2, "pinFirst": 1, "proactiveCompressionThreshold": 0.3 }, "vocabulary": { "terms": [] }, "dataCollection": { "fields": [ { "key": "string", "label": "string", "kind": "full_name", "required": false, "prompt": "" } ] }, "tools": [], "knowledge": { "kbId": "string", "maxResults": 4, "minScore": 0 }, "sourceTemplateId": "string" }}{ "error": "string", "message": "string", "limit": 0, "length": 0, "reason": "string"}{ "error": "string", "message": "string", "limit": 0, "length": 0, "reason": "string"}{ "error": "string", "message": "string", "limit": 0, "length": 0, "reason": "string"}