Update Voice AI Agent - Kallabot Documentation

PUT

/

agent

/

{agent_id}

Update an existing agent

curl --request PUT \
  --url https://api.kallabot.com/agent/{agent_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "agent_config": {
    "agent_name": "Alfred",
    "agent_welcome_message": "Updated welcome",
    "call_direction": "inbound",
    "inbound_phone_number": "+14155551234",
    "tasks": []
  },
  "agent_prompts": {
    "task_1": {
      "system_prompt": "You are updated prompt"
    }
  }
}
'

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    agent_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    agent_config: {
      agent_name: 'Alfred',
      agent_welcome_message: 'Updated welcome',
      call_direction: 'inbound',
      inbound_phone_number: '+14155551234',
      tasks: []
    },
    agent_prompts: {task_1: {system_prompt: 'You are updated prompt'}}
  })
};

fetch('https://api.kallabot.com/agent/{agent_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.kallabot.com/agent/{agent_id}"

payload = {
    "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "agent_config": {
        "agent_name": "Alfred",
        "agent_welcome_message": "Updated welcome",
        "call_direction": "inbound",
        "inbound_phone_number": "+14155551234",
        "tasks": []
    },
    "agent_prompts": { "task_1": { "system_prompt": "You are updated prompt" } }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "status": "success",
  "message": "Agent updated successfully",
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "callback_configured": true,
  "ready_for_inbound_calls": true,
  "ready_for_outbound_calls": true,
  "warning": null
}

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

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

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

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

Agent UUID to update. Must match agent_id in request body.

Body

application/json

Updated agent payload. Include the same agent_id as in the path and the new agent_config/agent_prompts.

Payload for updating an existing agent. The agent_id in the body should match the {agent_id} path parameter.

agent_id

string<uuid>

required

Agent UUID (must match URL path parameter).

agent_config

object

required

Show child attributes

agent_prompts

object

required

Show child attributes

Response

Agent updated successfully

Response returned after a successful agent update.

status

string

required

Example:

"success"

message

string

required

Example:

"Agent updated successfully"

agent_id

string<uuid>

required

callback_configured

boolean | null

True when inbound callback status is configured and validated.

ready_for_inbound_calls

boolean | null

ready_for_outbound_calls

boolean

Example:

true

warning

string | null

Update an existing agent

curl --request PUT \
  --url https://api.kallabot.com/agent/{agent_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "agent_config": {
    "agent_name": "Alfred",
    "agent_welcome_message": "Updated welcome",
    "call_direction": "inbound",
    "inbound_phone_number": "+14155551234",
    "tasks": []
  },
  "agent_prompts": {
    "task_1": {
      "system_prompt": "You are updated prompt"
    }
  }
}
'

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    agent_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    agent_config: {
      agent_name: 'Alfred',
      agent_welcome_message: 'Updated welcome',
      call_direction: 'inbound',
      inbound_phone_number: '+14155551234',
      tasks: []
    },
    agent_prompts: {task_1: {system_prompt: 'You are updated prompt'}}
  })
};

fetch('https://api.kallabot.com/agent/{agent_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.kallabot.com/agent/{agent_id}"

payload = {
    "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "agent_config": {
        "agent_name": "Alfred",
        "agent_welcome_message": "Updated welcome",
        "call_direction": "inbound",
        "inbound_phone_number": "+14155551234",
        "tasks": []
    },
    "agent_prompts": { "task_1": { "system_prompt": "You are updated prompt" } }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "status": "success",
  "message": "Agent updated successfully",
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "callback_configured": true,
  "ready_for_inbound_calls": true,
  "ready_for_outbound_calls": true,
  "warning": null
}

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

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

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