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