Versioning

Versioning lets you change an assistant or tool without affecting live calls. Publish the draft when it is ready, review earlier versions, or restore an earlier configuration.

The versioning lifecycle

Assistants and tools both support drafts, publishing, and version history:

• Draft: Contains your unpublished changes. Drafts are per user, so your edits stay separate from your teammates’. Draft changes do not affect live calls.
• Publish: Creates a new version from the draft. The new version becomes the current published version.
• History: Keeps every published version so you can review what changed and when.
• Restore an assistant: Immediately creates a new current version from an earlier configuration and replaces any draft changes.
• Restore a tool: Loads an earlier configuration into the draft. Publish the restored draft to create the next current version.

Which version a call uses

• Inbound calls use the assistant’s current published version. You cannot select another version for an inbound call.
• Outbound and web calls use the current published version by default. To use a specific published version, pass assistantVersion with assistantId in the create call request.

Next steps