Documentation Index
Fetch the complete documentation index at: https://docs.insitechat.ai/llms.txt
Use this file to discover all available pages before exploring further.
Two read-only InsiteChat API endpoints for inspecting the chatbots on your account. Useful for building custom dashboards, dropdown pickers, or any workflow that needs to enumerate the chatbots you own.
List Chatbots
Returns every chatbot owned by the API key’s user (excluding soft-deleted ones).
Request
curl https://backend.insitechat.ai/api/v1/chatbots \
-H "Authorization: Bearer ic_your-api-key"
Response
A bare JSON array (no wrapping envelope):
[
{
"id": "0a1b2c3d-4e5f-6789-abcd-ef0123456789",
"name": "Support Bot",
"slug": "support-bot",
"provider": "gemini",
"is_active": true,
"created_at": "2026-03-15T10:30:00.123456+00:00"
},
{
"id": "1b2c3d4e-5f67-89ab-cdef-0123456789ab",
"name": "Sales Assistant",
"slug": "sales-assistant",
"provider": "chatgpt",
"is_active": true,
"created_at": "2026-03-20T09:00:00.654321+00:00"
}
]
Response Fields
| Field | Type | Description |
|---|
id | UUID | Unique chatbot identifier (bare UUID, no prefix). |
name | string | Display name. |
slug | string | URL-friendly slug derived from the name. |
provider | string | LLM backend: gemini, chatgpt, or ollama. |
is_active | boolean | false if the owner paused the chatbot from the dashboard. |
created_at | string | ISO 8601 timestamp. |
Get Chatbot Details
Returns the configuration for a single chatbot.
Request
GET /v1/chatbots/{chatbot_id}
| Path parameter | Type | Required | Description |
|---|
chatbot_id | UUID | yes | The chatbot’s UUID (from the list response). |
curl https://backend.insitechat.ai/api/v1/chatbots/0a1b2c3d-4e5f-6789-abcd-ef0123456789 \
-H "Authorization: Bearer ic_your-api-key"
Response
{
"id": "0a1b2c3d-4e5f-6789-abcd-ef0123456789",
"name": "Support Bot",
"slug": "support-bot",
"provider": "gemini",
"system_prompt": "You are a helpful customer support assistant for Acme Inc.",
"fallback_message": "I'm sorry, I don't have enough information to answer that.",
"is_active": true,
"created_at": "2026-03-15T10:30:00.123456+00:00"
}
Response Fields
| Field | Type | Description |
|---|
id | UUID | Unique chatbot identifier. |
name | string | Display name. |
slug | string | URL-friendly slug. |
provider | string | LLM backend (gemini, chatgpt, ollama). |
system_prompt | string | The persona / system prompt the chatbot uses. |
fallback_message | string | The reply used when the LLM can’t answer (or returns empty). |
is_active | boolean | Paused state. |
created_at | string | ISO 8601 timestamp. |
Chatbot IDs are bare UUIDs — there is no bot_ prefix. You can also find a chatbot’s UUID in the dashboard URL (/dashboard/chatbots/{uuid}/...).
Error Responses
Error bodies use Django Ninja’s default {"detail": "..."} shape.
| Status | When |
|---|
401 | Missing, invalid, or revoked API key |
404 | No chatbot exists with that UUID, or it belongs to a different user |
429 | Per-key rate limit exceeded |
