Skip to main content
PATCH
/
v1
/
agents
/
{agent_id}
Update agent
curl --request PATCH \
  --url https://api.callrounded.com/v1/agents/{agent_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '{
  "name": "<string>",
  "language": "en",
  "initial_message": "<string>",
  "initial_message_delay": 123,
  "max_call_duration": 123,
  "presence_check_phrases": [
    "<string>"
  ],
  "presence_check_idle_threshold": 123,
  "presence_check_max_times": 123,
  "base_prompt": "<string>",
  "voice": {
    "provider": "openai",
    "name": "Clara",
    "instructions": "Warm, empathetic, friendly",
    "speed": 0.5
  },
  "states": [
    {
      "name": "appointment_booking",
      "prompt": "You are a helpful assistant",
      "llm": {
        "model": "gpt-4o",
        "temperature": 0.5,
        "provider": "azure_openai"
      },
      "tools": [
        {
          "description": "Wait for 2 seconds",
          "type": "wait"
        },
        {
          "description": "Hang up the call",
          "filler_sentence": "Goodbye!",
          "type": "hang_up"
        },
        {
          "description": "Transfer the call to the next available assistant",
          "filler_sentence": "I'\''m transferring you to the next available assistant...",
          "type": "transfer_call"
        },
        {
          "description": "Leave a voicemail message",
          "filler_sentence": "I tried to call you but you didn'\''t answer. Please call me back at 1234567890",
          "type": "leave_voicemail_message"
        },
        {
          "content_type": "url_params",
          "description": "Get the availability of the requested assistant by using its name",
          "filler_sentence": "I'\''m checking the availability of the requested assistant...",
          "headers": [
            {
              "description": "The API key to use to call the custom function",
              "name": "Authorization",
              "value": "Bearer 123"
            }
          ],
          "method": "GET",
          "parameters": [
            {
              "description": "The name of the assistant to check the availability of",
              "name": "assistant_name",
              "type": "string"
            }
          ],
          "response_mapping": [
            {
              "destination_variable": "assistant_availability",
              "json_path_to_data": "$.availability"
            }
          ],
          "type": "custom_function",
          "url": "https://api.example.com/availability"
        }
      ],
      "transitions": [
        {
          "condition": "User provides valid input",
          "destination_state_name": "next_state_name",
          "filler_sentence": "I'\''m sorry, I didn'\''t catch that. Can you please repeat?"
        }
      ],
      "variables": [
        {
          "description": "The variable'\''s description",
          "extraction_instructions": "The instructions for the variable extraction",
          "name": "variable_name",
          "type": "string"
        }
      ],
      "x_position": -401.1747211895911,
      "y_position": 264.2527881040892,
      "features": {
        "entity_detection": true
      }
    }
  ],
  "initial_state_name": "<string>",
  "llm": {
    "model": "gpt-4o",
    "temperature": 0.5,
    "provider": "azure_openai"
  },
  "transcriber": {
    "provider": "azure"
  },
  "secure_recording_urls": true,
  "interruptions": true,
  "interruptions_sensitivity": "high",
  "webhook_url": "<string>",
  "webhook_subscriptions": [
    "event_variable_value_updated"
  ],
  "custom_vocabulary": [
    "<string>"
  ]
}'
{
  "message": "Agent draft configuration updated to version 2. Deploy it to make it active.",
  "data": {
    "name": "My first agent",
    "language": "en",
    "initial_message": "Hello, how can I help you today?",
    "initial_message_delay": 0,
    "max_call_duration": 300,
    "presence_check_phrases": [
      "Allo, vous êtes là ?",
      "Pouvez-vous répéter s'il vous plaît ?"
    ],
    "presence_check_idle_threshold": 10,
    "presence_check_max_times": 1,
    "base_prompt": "You are a helpful assistant",
    "voice": {
      "provider": "openai",
      "name": "Clara",
      "instructions": "Warm, empathetic, friendly",
      "speed": 0.5
    },
    "states": [
      {
        "name": "appointment_booking",
        "prompt": "You are a helpful assistant",
        "llm": {
          "model": "gpt-4o",
          "temperature": 0.5,
          "provider": "azure_openai"
        },
        "tools": [
          {
            "description": "Wait for 2 seconds",
            "type": "wait"
          },
          {
            "description": "Hang up the call",
            "filler_sentence": "Goodbye!",
            "type": "hang_up"
          },
          {
            "description": "Transfer the call to the next available assistant",
            "filler_sentence": "I'm transferring you to the next available assistant...",
            "type": "transfer_call"
          },
          {
            "description": "Leave a voicemail message",
            "filler_sentence": "I tried to call you but you didn't answer. Please call me back at 1234567890",
            "type": "leave_voicemail_message"
          },
          {
            "content_type": "url_params",
            "description": "Get the availability of the requested assistant by using its name",
            "filler_sentence": "I'm checking the availability of the requested assistant...",
            "headers": [
              {
                "description": "The API key to use to call the custom function",
                "name": "Authorization",
                "value": "Bearer 123"
              }
            ],
            "method": "GET",
            "parameters": [
              {
                "description": "The name of the assistant to check the availability of",
                "name": "assistant_name",
                "type": "string"
              }
            ],
            "response_mapping": [
              {
                "destination_variable": "assistant_availability",
                "json_path_to_data": "$.availability"
              }
            ],
            "type": "custom_function",
            "url": "https://api.example.com/availability"
          }
        ],
        "transitions": [
          {
            "condition": "User provides valid input",
            "destination_state_name": "next_state_name",
            "filler_sentence": "I'm sorry, I didn't catch that. Can you please repeat?"
          }
        ],
        "variables": [
          {
            "description": "The variable's description",
            "extraction_instructions": "The instructions for the variable extraction",
            "name": "variable_name",
            "type": "string"
          }
        ],
        "x_position": -401.1747211895911,
        "y_position": 264.2527881040892,
        "features": {
          "entity_detection": true
        }
      }
    ],
    "initial_state_name": "<string>",
    "llm": {
      "model": "gpt-4o",
      "temperature": 0.5,
      "provider": "azure_openai"
    },
    "transcriber": {
      "provider": "azure"
    },
    "secure_recording_urls": true,
    "interruptions": true,
    "interruptions_sensitivity": "high",
    "webhook_url": "https://webhook.site/123e4567-e89b-12d3-a456-426614174000",
    "webhook_subscriptions": [
      "event_variable_value_updated",
      "event_all_variables_resolved"
    ],
    "custom_vocabulary": [
      "super",
      "basta",
      "bravo",
      "gmail.com"
    ],
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "version": 1,
    "variables": [
      {
        "name": "name",
        "type": "string",
        "description": "The name of the customer",
        "extraction_instructions": "Extract the name of the customer"
      }
    ]
  },
  "error": {
    "details": [
      {
        "field": "email",
        "message": "Invalid email format"
      }
    ],
    "message": "An error occurred while processing your request",
    "status": 400,
    "type": "generic_error"
  },
  "status": 200
}

Authorizations

​
X-Api-Key
string
header
required

The API Key created in Rounded Studio.

Path Parameters

​
agent_id
string<uuid>
required

The ID of the agent to update.

Body

application/json

The agent data to update and generate a new configuration version. Some properties updates won't generate a new version as they are global settings and have immediate effect without requiring a deployment. These properties are:

  • name
  • webhook_url
  • webhook_subscriptions
  • secure_recording_urls

For other properties, a new version will be created and available to be deployed. Properties definitions are the same as the agent create request, see POST /v1/agents for the complete schema definition. The response includes headers about rate limiting.

​
name
string | null
​
language
enum<string> | null
Available options:
en,
fr,
fr-FR,
fr-BE,
fr-CA,
es,
de,
it,
nl,
pl,
ar,
pt,
el,
hr,
zh
​
initial_message
string | null
​
initial_message_delay
number | null
​
max_call_duration
number | null
​
presence_check_phrases
string[] | null
​
presence_check_idle_threshold
integer | null
​
presence_check_max_times
integer | null
​
base_prompt
string | null
​
voice
object | null
  • AgentCreateOpenAIVoiceConfigurationApiRequest
  • AgentCreateElevenLabsVoiceConfigurationApiRequest
  • AgentCreateCartesiaVoiceConfigurationApiRequest
  • AgentCreateAzureVoiceConfigurationApiRequest
​
states
AgentCreateStatesApiRequest · object[] | null
​
initial_state_name
string | null
​
llm
object | null
​
transcriber
object | null
​
secure_recording_urls
boolean | null
​
interruptions
boolean | null
​
interruptions_sensitivity
enum<string> | null
Available options:
high,
medium,
low
​
webhook_url
string | null
​
webhook_subscriptions
enum<string>[] | null
​
custom_vocabulary
string[] | null

Response

Successfully updated agent

​
data
object
required

The agent data retrieved after the update.

​
message
string
default:Agent updated successfully

Response message indicating the result of the operation. It will be different depending on the update type (when a new version is created or not).

Examples:

"Agent draft configuration updated to version 2. Deploy it to make it active."

"Agent global settings updated successfully."

​
error
object | null
Example:
{
  "details": [
    {
      "field": "email",
      "message": "Invalid email format"
    }
  ],
  "message": "An error occurred while processing your request",
  "status": 400,
  "type": "generic_error"
}
​
status
integer
default:200

HTTP status code of the response.