Create an agent template

Save a new template into the organization's own templates. config must reference every id declared in requirements, and every declared id must be referenced somewhere in config — a mismatch in either direction is rejected.

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Every requirement id referenced by a tool's or knowledge's requires inside config must be declared in requirements, and every declared requirement must be referenced somewhere in config — a mismatch in either direction is rejected as invalid_config.

name*string

The template's display name.

Length1 <= length <= 120

description?string

Shown on the template's card in the gallery.

Lengthlength <= 500

category*string

Groups templates in the gallery; also the type filter's values.

Length1 <= length <= 60

tags?array<>

Itemsitems <= 10

Default[]

status?string

Ignored on input, and accepted only so a template read back from the API can be sent again unchanged. draft is Tandem's staging state for a curated template and only a Tandem release writes one; your organization's own templates have no draft/publish workflow, so they are always created and updated live whatever this field says.

Default"live"

Value in

"draft"
"live"

config*

An agent configuration with every organization-scoped reference replaced by a requirement to bind at instantiate time: each tool binding and the knowledge block carry a requires key, naming a requirement, in place of their workflowId / integrationId / kbId. Sending one of those ids here is ignored rather than rejected — it is dropped, not stored, so the binding you sent has no effect. The same goes for sourceTemplateId: a template records no provenance of its own.

requirements?array<>

Default[]

sourceAgentId?string

The agent this template was derived from, if any. Provenance only — nothing links the template back to that agent, and there is no upgrade path from one to the other.

Match^[A-Za-z0-9_-]{1,64}$

Response Body

`application/json`

curl -X POST "https://example.com/v1/agent-media/agent-templates" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "category": "string",    "config": {      "name": "string"    }  }'

{  "template": {    "id": "string",    "name": "string",    "description": "string",    "category": "string",    "tags": [      "string"    ],    "status": "draft",    "scope": "org",    "config": {      "name": "string",      "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": {        "requires": "string",        "maxResults": 4,        "minScore": 0      }    },    "requirements": [      {        "id": "string",        "kind": "workflow",        "label": "string",        "description": "string",        "optional": false,        "integrationType": "string",        "defaultBinding": {          "workflowId": "string"        }      }    ],    "sourceAgentId": "string",    "createdBy": "string",    "updatedBy": "string",    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z"  }}

{  "error": "string",  "errors": [    {      "field": "string",      "message": "string"    }  ]}

{  "error": "string",  "message": "string",  "limit": 0,  "length": 0,  "reason": "string"}

{  "error": "string",  "message": "string",  "limit": 0,  "length": 0,  "reason": "string"}

Create an agent template

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`