Update a conversational agent
curl --request PUT \
--url https://api.operator.xyz/conversational_agents/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Operator-Version: <operator-version>' \
--data '
{
"name": null,
"description": null
}
'import requests
url = "https://api.operator.xyz/conversational_agents/{id}"
payload = {
"name": None,
"description": None
}
headers = {
"Operator-Version": "<operator-version>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {
'Operator-Version': '<operator-version>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({name: null, description: null})
};
fetch('https://api.operator.xyz/conversational_agents/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"version_id": "<string>"
}{
"code": "<string>",
"message": "<string>",
"data": "<unknown>"
}{
"code": "<string>",
"message": "<string>",
"data": "<unknown>"
}Conversational agents
Update a conversational agent
Updates the target agent (latest version by default, or specific version if provided) with the supplied data. These changes are saved to either a new draft or update an existing draft. Returns the version ID of the draft.
The new version of the agent will not be used by default until it is released.
PUT
/
conversational_agents
/
{id}
Update a conversational agent
curl --request PUT \
--url https://api.operator.xyz/conversational_agents/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Operator-Version: <operator-version>' \
--data '
{
"name": null,
"description": null
}
'import requests
url = "https://api.operator.xyz/conversational_agents/{id}"
payload = {
"name": None,
"description": None
}
headers = {
"Operator-Version": "<operator-version>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {
'Operator-Version': '<operator-version>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({name: null, description: null})
};
fetch('https://api.operator.xyz/conversational_agents/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"version_id": "<string>"
}{
"code": "<string>",
"message": "<string>",
"data": "<unknown>"
}{
"code": "<string>",
"message": "<string>",
"data": "<unknown>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The API version to use.
Available options:
2025-06-19 Path Parameters
The ID of the agent to update. Use ca_8qm9JBCiTe7 for the latest version, or ca_8qm9JBCiTe7@v2 for a specific version.
Body
application/json
Human-readable name for the agent.
Description of the agent.
Full configuration for the agent (e.g. voice, runtime, tools).
Show child attributes
Show child attributes
List of postprocessing procedural agent IDs that run after the conversation ends, e.g. ["pa_8qm9JBCiTe7"]

