Skip to main content
All endpoints require authentication. See Auth.

​
Endpoints

​
List Bots

GET /api/bots
Returns all bots for the authenticated user.

​
Create Bot

POST /api/bots
Body
FieldTypeRequiredDescription
namestringYesMin. 3 characters
descriptionstringYesMin. 10 characters
systemPromptstringYesInstructions for the bot
colorThemestringNoblue, indigo, purple, green, red, orange, yellow
activebooleanNoDefault true

​
Get Bot

GET /api/bots/:id

​
Update Bot

PATCH /api/bots/:id
Partial update — send only the fields you want to change.

​
Delete Bot

DELETE /api/bots/:id

​
Bot Knowledge Base — Files

​
List Files

GET /api/bots/:id/files

​
Upload File

POST /api/bots/:id/files
Content-Type: multipart/form-data
FieldTypeDescription
filefilePDF or text file for RAG training

​
Delete File

DELETE /api/bots/:id/files/:fileId

​
Bot Knowledge Base — URLs

​
List URLs

GET /api/bots/:id/urls

​
Add URL

POST /api/bots/:id/urls
FieldTypeDescription
urlstringURL to scrape and embed

​
Delete URL

DELETE /api/bots/:id/urls/:urlId

​
Bot Tools

​
List Tools

GET /api/bots/:id/tools

​
Attach Tool

POST /api/bots/:id/tools
FieldTypeDescription
toolIdnumberID of the tool to attach

​
Remove Tool

DELETE /api/bots/:botId/tools/:toolId

​
Bot Webhooks

​
List Webhooks

GET /api/bots/:id/webhooks

​
Add Webhook

POST /api/bots/:id/webhooks

​
Update Webhook

PATCH /api/bots/:id/webhooks/:webhookId