Skip to main content
PATCH
/
v2
/
agent
/
{agent_id}
cURL
curl --request PATCH \
  --url https://api.bolna.ai/v2/agent/{agent_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_config": {
    "agent_name": "Alfred",
    "agent_welcome_message": "How are you doing Bruce?",
    "webhook_url": null,
    "synthesizer": {
      "provider": "elevenlabs",
      "provider_config": {
        "voice": "Nila",
        "voice_id": "V9LCAAi4tTlqe9JadbCo",
        "model": "eleven_turbo_v2_5"
      },
      "stream": true,
      "buffer_size": 250,
      "audio_format": "wav"
    },
    "ingest_source_config": {
      "source_type": "api",
      "source_url": "https://example.com/api/data",
      "source_auth_token": "abc123",
      "source_name": "leads_sheet_june.csv"
    },
    "telephony_provider": "sip-trunk"
  },
  "agent_prompts": {
    "task_1": {
      "system_prompt": "What is the Ultimate Question of Life, the Universe, and Everything?"
    }
  }
}
'
{
  "message": "success",
  "state": "updated"
}
Currently, only the following agent attributes can be updated for the PATCH update.
  • agent_name
  • agent_welcome_message
  • webhook_url
  • synthesizer
  • agent_prompts
  • ingest_source_config
  • telephony_provider
If you are patching with telephony_provider set to sip-trunk, the next step is to set the inbound agent to map your SIP trunk phone number to an agent for receiving inbound calls.

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

Body

application/json

Update an agent

​
agent_config
object

Configuration of the agent

​
agent_prompts
object

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

Response

agent status response