Skip to main content
POST
cURL
Saves a configuration as a new version of the agent. The live agent and its calls don’t change until you make the version live. The body is the same as Update agent, validated the same way, plus two optional fields: The response carries the new version’s version_id. Use it to place a test call, save more edits into it or make it live.
This is different from Update agent, which saves into the live version and changes what calls use straight away.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id
string<uuid>
required

The agent's id

Body

application/json

The full agent configuration to save, as in PUT /v2/agent/{agent_id}

agent_config
object
required

Configuration of the agent

agent_prompts
object
required

Prompts to be provided to the agent. It can have multiple tasks of the form task_<task_id>

version_name
string

Name for the new version. Defaults to the next number, such as v4.

Example:

"Holiday offer"

tags
string[]

Response

Version saved

agent_id
string<uuid>
version_id
string<uuid>

id of the save just written

version_name
string
state
enum<string>

saved for a new version, updated for a save into an existing version

Available options:
saved,
updated