Skip to main content
An agent version is a saved copy of an agent’s full configuration. One version is live and every call uses it, unless the call passes another version’s id as agent_version_id to POST /call. Versions apply to regular agents; graph agents have their own version history. To compare versions on real calls, see A/B test agent versions.

Endpoints

Agent version object attributes

  • id string
    Unique identifier of the version. Pass it as agent_version_id to the version endpoints and to POST /call
  • version_name string
    Name of the version, unique within the agent. New versions are named v1, v2 and so on until you rename them
  • tags array
    Tags for the version
  • version_status string
    saved for the save created with Save as new version, published for later saves into the version or saves of the live version
  • is_current boolean
    true for the live version
  • created_at string
    When this save was made
  • updated_at string
    When this save was last updated
Every save into a version shares its version_name, and each save gets a new id. Saving edits into a version returns the new id; use it for the next request. Renaming or deleting a version applies to all of its saves, and the live version can’t be deleted.