AssistantsVersioning

Versioning with tools

Publish, view history, and restore versions of a tool

How tool versioning works

Tools follow the versioning lifecycle. Edit the draft, then publish it to create a version. Published versions do not change. To reuse an earlier configuration, restore it to the draft and publish the draft as the next version.

A tool’s versions are independent of an assistant’s versions. An assistant can use a specific tool version or the Latest version. See How versioning works with assistants and tools.

The tool header shows the selected version. A draft appears separately when the tool has unpublished changes.

Publish a new version

Publishing turns your current draft into a new version and makes it the current version.

1

Open the tool

Open the Dashboard, select Tools, and select the tool you want to update.

2

Edit the tool

Change the tool’s configuration. Vapi saves your edits automatically as a draft. The changes do not affect live calls.

3

Review the changes

Select Publish to compare the draft with the current published version. In the diff, you can copy individual lines, wrap long lines, move between changes, or copy the complete diff.

4

Name and describe the version

Give the version a name. You can also add a short description so teammates understand what changed and why.

5

Publish

Select Publish to create the version and make it current. To publish with the default settings, select Quick Publish. To remove the draft changes, select Discard Changes….

View version history

1

Open the tool

Open the Dashboard, select Tools, and select the tool whose history you want to review.

2

Open the version menu

Select the version number in the tool header to see recent versions. The current published version is marked Current.

3

Open the full history

Select View Full History. Each version includes its version number, name, description, and publication time.

From the version history you can:

  • Select View changes to compare a version with the previous version
  • Select Export to download a version as JSON
  • Select Restore to load a version into the draft

Restore a previous version

1

Choose a version

Open the version history and select Restore for an earlier version.

2

Confirm the restore

Review the confirmation, then select Restore. Vapi loads the selected configuration into the editor as a draft and replaces the current draft changes.

3

Publish the restored configuration

Review the draft, then select Publish to create the next version and make it current.

Restoring a version replaces the tool’s current draft changes.

Restoring a tool version does not change which version an assistant uses. The assistant continues to use the selected version or Latest. See How versioning works with assistants and tools.

Next steps

Versioning overview

Save, publish, and restore versions of your assistants and tools.

Versioning with assistants

Publish, view history, and restore versions of an assistant.

How versioning works with assistants and tools

Choose the tool versions an assistant uses and learn how restoring an assistant affects them.