POST
/
inbound
/
update
curl --request POST \
  --url https://api.bland.ai/inbound/update \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "phone_number": "<string>",
  "prompt": "<string>",
  "voice_id": 123
}'
{
  "id": 1,
  "created_at": "2023-10-10T12:00:00Z",
  "phone_number": "+1234567890",
  "prompt": "New Prompt Text",
  "status": "active"
}

Headers

authorization
string
required

Your API key for authentication.

Body

phone_number
string

The phone number associated with the prompt. - Format: “+XXXXXXXXXX” or “+XXX-XXX-XXXX”. Make sure to include the exact phone number (area code and ”+” included). Otherwise the update will fail.

prompt
string

The new prompt for the given phone number. The prompt shouldn’t exceed 5000 characters. Note: Ensure the prompt is clear and relevant to your use case.

voice_id
integer

Set a custom voice for your agent. Matches the voices in the /call endpoint.

  • 0: British Female (default)
  • 1: Australian Female
  • 2: American Male

Response

id
integer

The unique ID associated with the inbound record.

created_at
string

The creation timestamp of the inbound record. - Example: “2023-10-10T12:00:00Z”

phone_number
string

The updated phone number. - Example: “+1234567890”

prompt
string

The updated prompt text.

status
string

The status of the inbound record. Typically “active”.