Publish a version
Point the agent at this version. From here on every call the agent answers runs this configuration, and the version becomes immutable — no body, no fields to send.
This is where the configuration is validated in full, and it is the only place some of those checks run at all. On top of the shape checking a draft save does, publishing requires the configuration to be complete (a systemPrompt, and the slots a model needs) and resolves everything it references: {{org.*}} variables and {{secrets.*}} must exist and must sit somewhere the placement rules allow, an ElevenLabs voice needs the ElevenLabs integration connected, and an agent tool must point at an agent that has something published of its own. Each failure comes back as invalid_config with an errors array naming the field, and the pointer does not move.
Publishing does not change updatedBy — a publish is not an edit of the draft, and overwriting it would lose who last changed the configuration. It sets publishedAt on the version.
The first publish retires this agent's configuration PUT. From here on PUT /v1/agent-media/agents/{agentId} accepts only name and sourceTemplateId and answers 409 config_put_retired to a body carrying anything else. That is the point of publishing — the configuration now lives on the versions — but it is a one-way change to an endpoint an existing integration may still be writing to, so check before you publish an agent something else maintains.
There is no unpublish. Point the agent at a different version instead.
Authorization
bearerAuth A Tandem bearer token. Requests are scoped to the organization the token belongs to; no organization header is required.
In: header
Path Parameters
The agent's unique ID.
The version number: <major>.<minor>, two non-negative integers with no leading zeros and at most nine digits each — 0.1, 1.0, 2.13. You choose it. Anything else is rejected with invalid_version, because the number is part of the version's storage key.
^(0|[1-9]\d{0,8})\.(0|[1-9]\d{0,8})$Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/agent-media/agents/string/versions/string/publish"{ "version": { "version": "string", "description": "string", "publishedAt": "2019-08-24T14:15:22Z", "createdBy": "string", "updatedBy": "string", "backfilledAt": "2019-08-24T14:15:22Z", "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 } }}{ "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"}{ "error": "string", "message": "string", "limit": 0, "length": 0, "reason": "string"}{ "error": "string", "message": "string", "limit": 0, "length": 0, "reason": "string"}