Update chatbot settings

Update the configuration and settings of an existing chatbot. You only need to pass the fields you wish to update.

PATCH/chatbots/{chatbotId}

Request parameters

Path

chatbotIdstringrequired

The unique UUID of the chatbot you want to update.

Body

namestring

The new name of the chatbot.

settingsobject

The updated configuration object (e.g. changing the theme or prompt).

is_activeboolean

Set to false to pause the chatbot and prevent it from answering.

Headers

Authorizationstringrequired

Your API Key formatted as Bearer sk_live_…

Response

dataobject

The updated chatbot object.

idstring

The unique UUID identifier of the chatbot.

namestring

The name of the chatbot.

settingsobject

Configuration object containing theme and prompt details.

is_activeboolean

Whether the chatbot is currently enabled and active.

created_atstring

The ISO 8601 timestamp of when the chatbot was created.

cURL

curl -X PATCH https://api.picobot.com/v1/chatbots/91981020-f783-4544-ad96-39857ac589cb \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Updated API Bot", "is_active": false}'

Node.js

fetch('https://api.picobot.com/v1/chatbots/91981020-f783-4544-ad96-39857ac589cb', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Updated API Bot',
    is_active: false
  })
})
.then(res => res.json())
.then(console.log);

Python

import requests

headers = {
    "Authorization": "Bearer <token>"
}
json_data = {
    "name": "Updated API Bot",
    "is_active": False
}
response = requests.patch("https://api.picobot.com/v1/chatbots/91981020-f783-4544-ad96-39857ac589cb", headers=headers, json=json_data)
print(response.json())

Java

HttpResponse<String> response = Unirest.patch("https://api.picobot.com/v1/chatbots/91981020-f783-4544-ad96-39857ac589cb")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\"name\": \"Updated API Bot\", \"is_active\": false}")
  .asString();

{
  "data": {
    "id": "91981020-f783-4544-ad96-39857ac589cb",
    "name": "Updated API Bot",
    "settings": {
      "theme": "dark"
    },
    "is_active": false,
    "created_at": "2026-06-19T21:21:06.572Z"
  }
}