Retrieve chatbot

Retrieve a specific chatbot by its unique identifier.

GET/chatbots/{chatbotId}

Request parameters

Path

chatbotIdstringrequired

The unique UUID of the chatbot.

Headers

Authorizationstringrequired

Your API Key formatted as Bearer sk_live_…

Response

dataobject

The 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 GET https://app.picobot.dev/api/chatbots/91981020-f783-4544-ad96-39857ac589cb \
  -H "Authorization: Bearer <token>"

Node.js

fetch('https://app.picobot.dev/api/chatbots/91981020-f783-4544-ad96-39857ac589cb', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <token>'
  }
})
.then(res => res.json())
.then(console.log);

Python

import requests

headers = {
    "Authorization": "Bearer <token>"
}
response = requests.get("https://app.picobot.dev/api/chatbots/91981020-f783-4544-ad96-39857ac589cb", headers=headers)
print(response.json())

Java

HttpResponse<String> response = Unirest.get("https://app.picobot.dev/api/chatbots/91981020-f783-4544-ad96-39857ac589cb")
  .header("Authorization", "Bearer <token>")
  .asString();

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