Update agent version API

PUT

agent

{agent_id}

versions

{agent_version_id}

cURL

curl --request PUT \
  --url https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_config": {
    "agent_name": "Alfred",
    "tasks": [
      {
        "task_config": {
          "hangup_after_silence": 10,
          "hangup_after_LLMCall": false,
          "incremental_delay": 400,
          "number_of_words_for_interruption": 2,
          "call_cancellation_prompt": null,
          "backchanneling": false,
          "backchanneling_message_gap": 5,
          "backchanneling_start_delay": 5,
          "ambient_noise": false,
          "ambient_noise_track": "coffee-shop",
          "call_terminate": 90,
          "inbound_limit": -1,
          "whitelist_phone_numbers": null,
          "disallow_unknown_numbers": false,
          "dtmf_enabled": false,
          "auto_reschedule": false,
          "welcome_message_delay": 0,
          "noise_cancellation_level": null,
          "call_hangup_message": null,
          "interruptible_hangup_message": false,
          "check_if_user_online": true,
          "trigger_user_online_message_after": 10,
          "voicemail": false,
          "voicemail_detection_duration": 30,
          "voicemail_check_interval": 7,
          "voicemail_min_transcript_length": 7,
          "voicemail_detection_time": null
        }
      }
    ],
    "agent_welcome_message": "How are you doing Bruce?",
    "webhook_url": "https://your-server.com/webhook",
    "agent_type": "other",
    "ingest_source_config": {
      "source_type": "api",
      "source_url": "https://example.com/api/data",
      "source_auth_token": "abc123",
      "source_name": "leads_sheet_june.csv"
    },
    "calling_guardrails": {
      "call_start_hour": 9,
      "call_end_hour": 17
    },
    "call_summary_enabled": false
  },
  "agent_prompts": {}
}
'

import requests

url = "https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}"

payload = {
    "agent_config": {
        "agent_name": "Alfred",
        "tasks": [{ "task_config": {
                    "hangup_after_silence": 10,
                    "hangup_after_LLMCall": False,
                    "incremental_delay": 400,
                    "number_of_words_for_interruption": 2,
                    "call_cancellation_prompt": None,
                    "backchanneling": False,
                    "backchanneling_message_gap": 5,
                    "backchanneling_start_delay": 5,
                    "ambient_noise": False,
                    "ambient_noise_track": "coffee-shop",
                    "call_terminate": 90,
                    "inbound_limit": -1,
                    "whitelist_phone_numbers": None,
                    "disallow_unknown_numbers": False,
                    "dtmf_enabled": False,
                    "auto_reschedule": False,
                    "welcome_message_delay": 0,
                    "noise_cancellation_level": None,
                    "call_hangup_message": None,
                    "interruptible_hangup_message": False,
                    "check_if_user_online": True,
                    "trigger_user_online_message_after": 10,
                    "voicemail": False,
                    "voicemail_detection_duration": 30,
                    "voicemail_check_interval": 7,
                    "voicemail_min_transcript_length": 7,
                    "voicemail_detection_time": None
                } }],
        "agent_welcome_message": "How are you doing Bruce?",
        "webhook_url": "https://your-server.com/webhook",
        "agent_type": "other",
        "ingest_source_config": {
            "source_type": "api",
            "source_url": "https://example.com/api/data",
            "source_auth_token": "abc123",
            "source_name": "leads_sheet_june.csv"
        },
        "calling_guardrails": {
            "call_start_hour": 9,
            "call_end_hour": 17
        },
        "call_summary_enabled": False
    },
    "agent_prompts": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    agent_config: {
      agent_name: 'Alfred',
      tasks: [
        {
          task_config: {
            hangup_after_silence: 10,
            hangup_after_LLMCall: false,
            incremental_delay: 400,
            number_of_words_for_interruption: 2,
            call_cancellation_prompt: null,
            backchanneling: false,
            backchanneling_message_gap: 5,
            backchanneling_start_delay: 5,
            ambient_noise: false,
            ambient_noise_track: 'coffee-shop',
            call_terminate: 90,
            inbound_limit: -1,
            whitelist_phone_numbers: null,
            disallow_unknown_numbers: false,
            dtmf_enabled: false,
            auto_reschedule: false,
            welcome_message_delay: 0,
            noise_cancellation_level: null,
            call_hangup_message: null,
            interruptible_hangup_message: false,
            check_if_user_online: true,
            trigger_user_online_message_after: 10,
            voicemail: false,
            voicemail_detection_duration: 30,
            voicemail_check_interval: 7,
            voicemail_min_transcript_length: 7,
            voicemail_detection_time: null
          }
        }
      ],
      agent_welcome_message: 'How are you doing Bruce?',
      webhook_url: 'https://your-server.com/webhook',
      agent_type: 'other',
      ingest_source_config: {
        source_type: 'api',
        source_url: 'https://example.com/api/data',
        source_auth_token: 'abc123',
        source_name: 'leads_sheet_june.csv'
      },
      calling_guardrails: {call_start_hour: 9, call_end_hour: 17},
      call_summary_enabled: false
    },
    agent_prompts: {}
  })
};

fetch('https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'agent_config' => [
        'agent_name' => 'Alfred',
        'tasks' => [
                [
                                'task_config' => [
                                                                'hangup_after_silence' => 10,
                                                                'hangup_after_LLMCall' => false,
                                                                'incremental_delay' => 400,
                                                                'number_of_words_for_interruption' => 2,
                                                                'call_cancellation_prompt' => null,
                                                                'backchanneling' => false,
                                                                'backchanneling_message_gap' => 5,
                                                                'backchanneling_start_delay' => 5,
                                                                'ambient_noise' => false,
                                                                'ambient_noise_track' => 'coffee-shop',
                                                                'call_terminate' => 90,
                                                                'inbound_limit' => -1,
                                                                'whitelist_phone_numbers' => null,
                                                                'disallow_unknown_numbers' => false,
                                                                'dtmf_enabled' => false,
                                                                'auto_reschedule' => false,
                                                                'welcome_message_delay' => 0,
                                                                'noise_cancellation_level' => null,
                                                                'call_hangup_message' => null,
                                                                'interruptible_hangup_message' => false,
                                                                'check_if_user_online' => true,
                                                                'trigger_user_online_message_after' => 10,
                                                                'voicemail' => false,
                                                                'voicemail_detection_duration' => 30,
                                                                'voicemail_check_interval' => 7,
                                                                'voicemail_min_transcript_length' => 7,
                                                                'voicemail_detection_time' => null
                                ]
                ]
        ],
        'agent_welcome_message' => 'How are you doing Bruce?',
        'webhook_url' => 'https://your-server.com/webhook',
        'agent_type' => 'other',
        'ingest_source_config' => [
                'source_type' => 'api',
                'source_url' => 'https://example.com/api/data',
                'source_auth_token' => 'abc123',
                'source_name' => 'leads_sheet_june.csv'
        ],
        'calling_guardrails' => [
                'call_start_hour' => 9,
                'call_end_hour' => 17
        ],
        'call_summary_enabled' => false
    ],
    'agent_prompts' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}"

	payload := strings.NewReader("{\n  \"agent_config\": {\n    \"agent_name\": \"Alfred\",\n    \"tasks\": [\n      {\n        \"task_config\": {\n          \"hangup_after_silence\": 10,\n          \"hangup_after_LLMCall\": false,\n          \"incremental_delay\": 400,\n          \"number_of_words_for_interruption\": 2,\n          \"call_cancellation_prompt\": null,\n          \"backchanneling\": false,\n          \"backchanneling_message_gap\": 5,\n          \"backchanneling_start_delay\": 5,\n          \"ambient_noise\": false,\n          \"ambient_noise_track\": \"coffee-shop\",\n          \"call_terminate\": 90,\n          \"inbound_limit\": -1,\n          \"whitelist_phone_numbers\": null,\n          \"disallow_unknown_numbers\": false,\n          \"dtmf_enabled\": false,\n          \"auto_reschedule\": false,\n          \"welcome_message_delay\": 0,\n          \"noise_cancellation_level\": null,\n          \"call_hangup_message\": null,\n          \"interruptible_hangup_message\": false,\n          \"check_if_user_online\": true,\n          \"trigger_user_online_message_after\": 10,\n          \"voicemail\": false,\n          \"voicemail_detection_duration\": 30,\n          \"voicemail_check_interval\": 7,\n          \"voicemail_min_transcript_length\": 7,\n          \"voicemail_detection_time\": null\n        }\n      }\n    ],\n    \"agent_welcome_message\": \"How are you doing Bruce?\",\n    \"webhook_url\": \"https://your-server.com/webhook\",\n    \"agent_type\": \"other\",\n    \"ingest_source_config\": {\n      \"source_type\": \"api\",\n      \"source_url\": \"https://example.com/api/data\",\n      \"source_auth_token\": \"abc123\",\n      \"source_name\": \"leads_sheet_june.csv\"\n    },\n    \"calling_guardrails\": {\n      \"call_start_hour\": 9,\n      \"call_end_hour\": 17\n    },\n    \"call_summary_enabled\": false\n  },\n  \"agent_prompts\": {}\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"agent_config\": {\n    \"agent_name\": \"Alfred\",\n    \"tasks\": [\n      {\n        \"task_config\": {\n          \"hangup_after_silence\": 10,\n          \"hangup_after_LLMCall\": false,\n          \"incremental_delay\": 400,\n          \"number_of_words_for_interruption\": 2,\n          \"call_cancellation_prompt\": null,\n          \"backchanneling\": false,\n          \"backchanneling_message_gap\": 5,\n          \"backchanneling_start_delay\": 5,\n          \"ambient_noise\": false,\n          \"ambient_noise_track\": \"coffee-shop\",\n          \"call_terminate\": 90,\n          \"inbound_limit\": -1,\n          \"whitelist_phone_numbers\": null,\n          \"disallow_unknown_numbers\": false,\n          \"dtmf_enabled\": false,\n          \"auto_reschedule\": false,\n          \"welcome_message_delay\": 0,\n          \"noise_cancellation_level\": null,\n          \"call_hangup_message\": null,\n          \"interruptible_hangup_message\": false,\n          \"check_if_user_online\": true,\n          \"trigger_user_online_message_after\": 10,\n          \"voicemail\": false,\n          \"voicemail_detection_duration\": 30,\n          \"voicemail_check_interval\": 7,\n          \"voicemail_min_transcript_length\": 7,\n          \"voicemail_detection_time\": null\n        }\n      }\n    ],\n    \"agent_welcome_message\": \"How are you doing Bruce?\",\n    \"webhook_url\": \"https://your-server.com/webhook\",\n    \"agent_type\": \"other\",\n    \"ingest_source_config\": {\n      \"source_type\": \"api\",\n      \"source_url\": \"https://example.com/api/data\",\n      \"source_auth_token\": \"abc123\",\n      \"source_name\": \"leads_sheet_june.csv\"\n    },\n    \"calling_guardrails\": {\n      \"call_start_hour\": 9,\n      \"call_end_hour\": 17\n    },\n    \"call_summary_enabled\": false\n  },\n  \"agent_prompts\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"agent_config\": {\n    \"agent_name\": \"Alfred\",\n    \"tasks\": [\n      {\n        \"task_config\": {\n          \"hangup_after_silence\": 10,\n          \"hangup_after_LLMCall\": false,\n          \"incremental_delay\": 400,\n          \"number_of_words_for_interruption\": 2,\n          \"call_cancellation_prompt\": null,\n          \"backchanneling\": false,\n          \"backchanneling_message_gap\": 5,\n          \"backchanneling_start_delay\": 5,\n          \"ambient_noise\": false,\n          \"ambient_noise_track\": \"coffee-shop\",\n          \"call_terminate\": 90,\n          \"inbound_limit\": -1,\n          \"whitelist_phone_numbers\": null,\n          \"disallow_unknown_numbers\": false,\n          \"dtmf_enabled\": false,\n          \"auto_reschedule\": false,\n          \"welcome_message_delay\": 0,\n          \"noise_cancellation_level\": null,\n          \"call_hangup_message\": null,\n          \"interruptible_hangup_message\": false,\n          \"check_if_user_online\": true,\n          \"trigger_user_online_message_after\": 10,\n          \"voicemail\": false,\n          \"voicemail_detection_duration\": 30,\n          \"voicemail_check_interval\": 7,\n          \"voicemail_min_transcript_length\": 7,\n          \"voicemail_detection_time\": null\n        }\n      }\n    ],\n    \"agent_welcome_message\": \"How are you doing Bruce?\",\n    \"webhook_url\": \"https://your-server.com/webhook\",\n    \"agent_type\": \"other\",\n    \"ingest_source_config\": {\n      \"source_type\": \"api\",\n      \"source_url\": \"https://example.com/api/data\",\n      \"source_auth_token\": \"abc123\",\n      \"source_name\": \"leads_sheet_june.csv\"\n    },\n    \"calling_guardrails\": {\n      \"call_start_hour\": 9,\n      \"call_end_hour\": 17\n    },\n    \"call_summary_enabled\": false\n  },\n  \"agent_prompts\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "agent_id": "123e4567-e89b-12d3-a456-426655440000",
  "version_id": "0b6f4f0e-2f4a-4f4e-9a59-5d0c7f1d2c3b",
  "version_name": "v4",
  "state": "updated"
}

{
  "error": 123,
  "message": "<string>"
}

{
  "message": "Agent version not found"
}

{
  "message": "This is the live version. Save the agent with PUT /v2/agent/{id} instead."
}

Saves a configuration into a version that isn’t live. The body is the same as Update agent: send the full configuration, for example the one from Get agent version with your changes. The save keeps the version’s name and tags but gets a new version_id, returned in the response. Use that id from now on, for later saves, test calls and set_current. List agent versions shows the version with its new id.

The live version returns 409. Save it with Update agent instead.

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

The agent's id

agent_version_id

string<uuid>

required

The version's id, from List agent versions

Body

application/json

The full agent configuration, as in PUT /v2/agent/{agent_id}

agent_config

object

required

Configuration of the agent

Show child attributes

agent_prompts

object

required

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

Show child attributes

Response

Version updated. version_id is the id of the new save; use it from now on.

agent_id

string<uuid>

version_id

string<uuid>

id of the save just written

version_name

string

state

enum<string>

saved for a new version, updated for a save into an existing version

Available options:

saved,

updated

cURL

curl --request PUT \
  --url https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_config": {
    "agent_name": "Alfred",
    "tasks": [
      {
        "task_config": {
          "hangup_after_silence": 10,
          "hangup_after_LLMCall": false,
          "incremental_delay": 400,
          "number_of_words_for_interruption": 2,
          "call_cancellation_prompt": null,
          "backchanneling": false,
          "backchanneling_message_gap": 5,
          "backchanneling_start_delay": 5,
          "ambient_noise": false,
          "ambient_noise_track": "coffee-shop",
          "call_terminate": 90,
          "inbound_limit": -1,
          "whitelist_phone_numbers": null,
          "disallow_unknown_numbers": false,
          "dtmf_enabled": false,
          "auto_reschedule": false,
          "welcome_message_delay": 0,
          "noise_cancellation_level": null,
          "call_hangup_message": null,
          "interruptible_hangup_message": false,
          "check_if_user_online": true,
          "trigger_user_online_message_after": 10,
          "voicemail": false,
          "voicemail_detection_duration": 30,
          "voicemail_check_interval": 7,
          "voicemail_min_transcript_length": 7,
          "voicemail_detection_time": null
        }
      }
    ],
    "agent_welcome_message": "How are you doing Bruce?",
    "webhook_url": "https://your-server.com/webhook",
    "agent_type": "other",
    "ingest_source_config": {
      "source_type": "api",
      "source_url": "https://example.com/api/data",
      "source_auth_token": "abc123",
      "source_name": "leads_sheet_june.csv"
    },
    "calling_guardrails": {
      "call_start_hour": 9,
      "call_end_hour": 17
    },
    "call_summary_enabled": false
  },
  "agent_prompts": {}
}
'

import requests

url = "https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}"

payload = {
    "agent_config": {
        "agent_name": "Alfred",
        "tasks": [{ "task_config": {
                    "hangup_after_silence": 10,
                    "hangup_after_LLMCall": False,
                    "incremental_delay": 400,
                    "number_of_words_for_interruption": 2,
                    "call_cancellation_prompt": None,
                    "backchanneling": False,
                    "backchanneling_message_gap": 5,
                    "backchanneling_start_delay": 5,
                    "ambient_noise": False,
                    "ambient_noise_track": "coffee-shop",
                    "call_terminate": 90,
                    "inbound_limit": -1,
                    "whitelist_phone_numbers": None,
                    "disallow_unknown_numbers": False,
                    "dtmf_enabled": False,
                    "auto_reschedule": False,
                    "welcome_message_delay": 0,
                    "noise_cancellation_level": None,
                    "call_hangup_message": None,
                    "interruptible_hangup_message": False,
                    "check_if_user_online": True,
                    "trigger_user_online_message_after": 10,
                    "voicemail": False,
                    "voicemail_detection_duration": 30,
                    "voicemail_check_interval": 7,
                    "voicemail_min_transcript_length": 7,
                    "voicemail_detection_time": None
                } }],
        "agent_welcome_message": "How are you doing Bruce?",
        "webhook_url": "https://your-server.com/webhook",
        "agent_type": "other",
        "ingest_source_config": {
            "source_type": "api",
            "source_url": "https://example.com/api/data",
            "source_auth_token": "abc123",
            "source_name": "leads_sheet_june.csv"
        },
        "calling_guardrails": {
            "call_start_hour": 9,
            "call_end_hour": 17
        },
        "call_summary_enabled": False
    },
    "agent_prompts": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    agent_config: {
      agent_name: 'Alfred',
      tasks: [
        {
          task_config: {
            hangup_after_silence: 10,
            hangup_after_LLMCall: false,
            incremental_delay: 400,
            number_of_words_for_interruption: 2,
            call_cancellation_prompt: null,
            backchanneling: false,
            backchanneling_message_gap: 5,
            backchanneling_start_delay: 5,
            ambient_noise: false,
            ambient_noise_track: 'coffee-shop',
            call_terminate: 90,
            inbound_limit: -1,
            whitelist_phone_numbers: null,
            disallow_unknown_numbers: false,
            dtmf_enabled: false,
            auto_reschedule: false,
            welcome_message_delay: 0,
            noise_cancellation_level: null,
            call_hangup_message: null,
            interruptible_hangup_message: false,
            check_if_user_online: true,
            trigger_user_online_message_after: 10,
            voicemail: false,
            voicemail_detection_duration: 30,
            voicemail_check_interval: 7,
            voicemail_min_transcript_length: 7,
            voicemail_detection_time: null
          }
        }
      ],
      agent_welcome_message: 'How are you doing Bruce?',
      webhook_url: 'https://your-server.com/webhook',
      agent_type: 'other',
      ingest_source_config: {
        source_type: 'api',
        source_url: 'https://example.com/api/data',
        source_auth_token: 'abc123',
        source_name: 'leads_sheet_june.csv'
      },
      calling_guardrails: {call_start_hour: 9, call_end_hour: 17},
      call_summary_enabled: false
    },
    agent_prompts: {}
  })
};

fetch('https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'agent_config' => [
        'agent_name' => 'Alfred',
        'tasks' => [
                [
                                'task_config' => [
                                                                'hangup_after_silence' => 10,
                                                                'hangup_after_LLMCall' => false,
                                                                'incremental_delay' => 400,
                                                                'number_of_words_for_interruption' => 2,
                                                                'call_cancellation_prompt' => null,
                                                                'backchanneling' => false,
                                                                'backchanneling_message_gap' => 5,
                                                                'backchanneling_start_delay' => 5,
                                                                'ambient_noise' => false,
                                                                'ambient_noise_track' => 'coffee-shop',
                                                                'call_terminate' => 90,
                                                                'inbound_limit' => -1,
                                                                'whitelist_phone_numbers' => null,
                                                                'disallow_unknown_numbers' => false,
                                                                'dtmf_enabled' => false,
                                                                'auto_reschedule' => false,
                                                                'welcome_message_delay' => 0,
                                                                'noise_cancellation_level' => null,
                                                                'call_hangup_message' => null,
                                                                'interruptible_hangup_message' => false,
                                                                'check_if_user_online' => true,
                                                                'trigger_user_online_message_after' => 10,
                                                                'voicemail' => false,
                                                                'voicemail_detection_duration' => 30,
                                                                'voicemail_check_interval' => 7,
                                                                'voicemail_min_transcript_length' => 7,
                                                                'voicemail_detection_time' => null
                                ]
                ]
        ],
        'agent_welcome_message' => 'How are you doing Bruce?',
        'webhook_url' => 'https://your-server.com/webhook',
        'agent_type' => 'other',
        'ingest_source_config' => [
                'source_type' => 'api',
                'source_url' => 'https://example.com/api/data',
                'source_auth_token' => 'abc123',
                'source_name' => 'leads_sheet_june.csv'
        ],
        'calling_guardrails' => [
                'call_start_hour' => 9,
                'call_end_hour' => 17
        ],
        'call_summary_enabled' => false
    ],
    'agent_prompts' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}"

	payload := strings.NewReader("{\n  \"agent_config\": {\n    \"agent_name\": \"Alfred\",\n    \"tasks\": [\n      {\n        \"task_config\": {\n          \"hangup_after_silence\": 10,\n          \"hangup_after_LLMCall\": false,\n          \"incremental_delay\": 400,\n          \"number_of_words_for_interruption\": 2,\n          \"call_cancellation_prompt\": null,\n          \"backchanneling\": false,\n          \"backchanneling_message_gap\": 5,\n          \"backchanneling_start_delay\": 5,\n          \"ambient_noise\": false,\n          \"ambient_noise_track\": \"coffee-shop\",\n          \"call_terminate\": 90,\n          \"inbound_limit\": -1,\n          \"whitelist_phone_numbers\": null,\n          \"disallow_unknown_numbers\": false,\n          \"dtmf_enabled\": false,\n          \"auto_reschedule\": false,\n          \"welcome_message_delay\": 0,\n          \"noise_cancellation_level\": null,\n          \"call_hangup_message\": null,\n          \"interruptible_hangup_message\": false,\n          \"check_if_user_online\": true,\n          \"trigger_user_online_message_after\": 10,\n          \"voicemail\": false,\n          \"voicemail_detection_duration\": 30,\n          \"voicemail_check_interval\": 7,\n          \"voicemail_min_transcript_length\": 7,\n          \"voicemail_detection_time\": null\n        }\n      }\n    ],\n    \"agent_welcome_message\": \"How are you doing Bruce?\",\n    \"webhook_url\": \"https://your-server.com/webhook\",\n    \"agent_type\": \"other\",\n    \"ingest_source_config\": {\n      \"source_type\": \"api\",\n      \"source_url\": \"https://example.com/api/data\",\n      \"source_auth_token\": \"abc123\",\n      \"source_name\": \"leads_sheet_june.csv\"\n    },\n    \"calling_guardrails\": {\n      \"call_start_hour\": 9,\n      \"call_end_hour\": 17\n    },\n    \"call_summary_enabled\": false\n  },\n  \"agent_prompts\": {}\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"agent_config\": {\n    \"agent_name\": \"Alfred\",\n    \"tasks\": [\n      {\n        \"task_config\": {\n          \"hangup_after_silence\": 10,\n          \"hangup_after_LLMCall\": false,\n          \"incremental_delay\": 400,\n          \"number_of_words_for_interruption\": 2,\n          \"call_cancellation_prompt\": null,\n          \"backchanneling\": false,\n          \"backchanneling_message_gap\": 5,\n          \"backchanneling_start_delay\": 5,\n          \"ambient_noise\": false,\n          \"ambient_noise_track\": \"coffee-shop\",\n          \"call_terminate\": 90,\n          \"inbound_limit\": -1,\n          \"whitelist_phone_numbers\": null,\n          \"disallow_unknown_numbers\": false,\n          \"dtmf_enabled\": false,\n          \"auto_reschedule\": false,\n          \"welcome_message_delay\": 0,\n          \"noise_cancellation_level\": null,\n          \"call_hangup_message\": null,\n          \"interruptible_hangup_message\": false,\n          \"check_if_user_online\": true,\n          \"trigger_user_online_message_after\": 10,\n          \"voicemail\": false,\n          \"voicemail_detection_duration\": 30,\n          \"voicemail_check_interval\": 7,\n          \"voicemail_min_transcript_length\": 7,\n          \"voicemail_detection_time\": null\n        }\n      }\n    ],\n    \"agent_welcome_message\": \"How are you doing Bruce?\",\n    \"webhook_url\": \"https://your-server.com/webhook\",\n    \"agent_type\": \"other\",\n    \"ingest_source_config\": {\n      \"source_type\": \"api\",\n      \"source_url\": \"https://example.com/api/data\",\n      \"source_auth_token\": \"abc123\",\n      \"source_name\": \"leads_sheet_june.csv\"\n    },\n    \"calling_guardrails\": {\n      \"call_start_hour\": 9,\n      \"call_end_hour\": 17\n    },\n    \"call_summary_enabled\": false\n  },\n  \"agent_prompts\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"agent_config\": {\n    \"agent_name\": \"Alfred\",\n    \"tasks\": [\n      {\n        \"task_config\": {\n          \"hangup_after_silence\": 10,\n          \"hangup_after_LLMCall\": false,\n          \"incremental_delay\": 400,\n          \"number_of_words_for_interruption\": 2,\n          \"call_cancellation_prompt\": null,\n          \"backchanneling\": false,\n          \"backchanneling_message_gap\": 5,\n          \"backchanneling_start_delay\": 5,\n          \"ambient_noise\": false,\n          \"ambient_noise_track\": \"coffee-shop\",\n          \"call_terminate\": 90,\n          \"inbound_limit\": -1,\n          \"whitelist_phone_numbers\": null,\n          \"disallow_unknown_numbers\": false,\n          \"dtmf_enabled\": false,\n          \"auto_reschedule\": false,\n          \"welcome_message_delay\": 0,\n          \"noise_cancellation_level\": null,\n          \"call_hangup_message\": null,\n          \"interruptible_hangup_message\": false,\n          \"check_if_user_online\": true,\n          \"trigger_user_online_message_after\": 10,\n          \"voicemail\": false,\n          \"voicemail_detection_duration\": 30,\n          \"voicemail_check_interval\": 7,\n          \"voicemail_min_transcript_length\": 7,\n          \"voicemail_detection_time\": null\n        }\n      }\n    ],\n    \"agent_welcome_message\": \"How are you doing Bruce?\",\n    \"webhook_url\": \"https://your-server.com/webhook\",\n    \"agent_type\": \"other\",\n    \"ingest_source_config\": {\n      \"source_type\": \"api\",\n      \"source_url\": \"https://example.com/api/data\",\n      \"source_auth_token\": \"abc123\",\n      \"source_name\": \"leads_sheet_june.csv\"\n    },\n    \"calling_guardrails\": {\n      \"call_start_hour\": 9,\n      \"call_end_hour\": 17\n    },\n    \"call_summary_enabled\": false\n  },\n  \"agent_prompts\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "agent_id": "123e4567-e89b-12d3-a456-426655440000",
  "version_id": "0b6f4f0e-2f4a-4f4e-9a59-5d0c7f1d2c3b",
  "version_name": "v4",
  "state": "updated"
}

{
  "error": 123,
  "message": "<string>"
}

{
  "message": "Agent version not found"
}

{
  "message": "This is the live version. Save the agent with PUT /v2/agent/{id} instead."
}

Get started

Voice agents

Telephony

Workflows

Account

Legacy

Update agent version API

Authorizations

Path Parameters

Body

Response