Update agent

Update an existing agent with a new configuration. You can update any of the agent’s properties including name, language, voice settings, and states. The update will generate a new version of the latest draft configuration of the agent. The response includes headers about rate limiting.

PATCH /v1/agents/{agent_id}

Update agent

cURL

curl --request PATCH \
  --url https://api.callrounded.com/v1/agents/{agent_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data @- <<EOF
{
  "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": {
    "name": "Alloy",
    "provider": "openai",
    "instructions": "Warm, empathetic, friendly",
    "speed": 1
  },
  "states": [
    {
      "name": "<string>",
      "prompt": "<string>",
      "llm": {
        "model": "gpt-3.5-turbo",
        "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-3.5-turbo",
    "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>"
  ]
}
EOF

200

Example

{
  "data": {
    "name": "<string>",
    "language": "en",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "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": {
      "name": "Alloy",
      "provider": "openai",
      "instructions": "Warm, empathetic, friendly",
      "speed": 1
    },
    "states": [
      {
        "name": "<string>",
        "prompt": "<string>",
        "llm": {
          "model": "gpt-3.5-turbo",
          "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-3.5-turbo",
      "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"
    ],
    "version": 1,
    "variables": [
      {
        "name": "<string>",
        "type": "<string>",
        "description": "The name of the customer",
        "extraction_instructions": "Extract the name of the customer"
      }
    ]
  },
  "message": "Agent updated successfully",
  "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.

• You can create it by going to the "API Keys" settings of your profile.
• Need help? You can email us at [e-mail] or join our Discord community.

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 · AgentCreateOpenAIVoiceConfigurationApiRequest · object

AgentCreateOpenAIVoiceConfigurationApiRequest

AgentCreateElevenLabsVoiceConfigurationApiRequest

AgentCreateCartesiaVoiceConfigurationApiRequest

AgentCreateAzureVoiceConfigurationApiRequest

AgentCreateGoogleVoiceConfigurationApiRequest

Show child attributes

states · AgentCreateStatesApiRequest · object[] | null

Show child attributes

initial_state_name · string | null

llm · AgentCreateLLMConfigurationApiRequest · object

Show child attributes

transcriber · AgentCreateTranscriberConfigurationApiRequest · object

Show child attributes

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

Available options: event_variable_value_updated, event_all_variables_resolved, event_call_status_updated, event_call_recording_status_updated, event_call_answer_type_updated, event_task_transition, event_transcript, event_transcript_complete, event_phone_call_connected, event_phone_call_ended, event_phone_call_did_not_connect, event_web_call_connected, event_web_call_ended, event_recording, event_action, event_synthesizer_consumption, event_post_call, event_pipedream_connection

custom_vocabulary · string[] | null

Response

200

application/json

Successfully updated agent

data · AgentGetApiResponseData · object · required

The agent data retrieved after the update.

Show child attributes

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 · ApiResponseError · object

Show child attributes

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.