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,
    "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": {}
}
'
{
  "message": "success",
  "state": "updated"
}

Documentation Index

Fetch the complete documentation index at: https://www.bolna.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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