PATCH
/
v1
/
agents
/
{agent_id}
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": "<string>",
  "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-4.1",
        "temperature": 0.5
      },
      "tools": [
        {
          "description": "Wait for 2 seconds",
          "type": "wait"
        }
      ],
      "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
    }
  ],
  "initial_state_name": "<string>",
  "llm": {
    "model": "gpt-4.1",
    "temperature": 0.5
  },
  "transcriber_configuration": {
    "provider": "azure"
  }
}'
{
"message": "Agent updated successfully",
"data": {},
"error": null,
"status": 200
}

Authorizations

X-Api-Key
string
header
required

The API Key created in Rounded Studio.

Path Parameters

agent_id
string
required

Body

application/json

Response

200
application/json

Successfully updated agent

The response is of type object.