How it works
The version boundary
Which settings a published version owns and restores on a rollback, and which settings edit live on the next call with no publish step.
Not every setting belongs to a version. The split is below.
Version-scoped
Held by the draft, live only once you publish, and restored exactly by a rollback:
- system prompt, greeting and returning-caller greeting;
- tools;
- variables, including which stored secret each secret variable points at;
- knowledge base sources and their embeddings;
- voice, language model, fallback model and speech-to-text model;
- conversation, turn detection and caller memory settings;
- name, description and call timezone;
- recording and disclosure settings, personal information redaction, telemetry content level.
Agent-scoped
Edits live, no publish involved, and unaffected by a version rollback:
- transcript retention;
- call-handling settings, such as voicemail detection, keypad input and call limits;
- the overflow forward number;
- pronunciation and recognition keyterms;
- safety guardrails;
- phone number assignment, collaborators, channels and the public share link.
Rolling back a version does not restore agent-scoped settings. And because they bypass publish, the validator checks them where they are written, not at publish time.
Rotating a secret
Rotating a secret's value applies to every version at once. A version records which secret a variable points at, never the value, so rotation is global by design.