API Reference

Overview

Botatos exposes a REST API on the gateway port (default: 18789). It also provides an OpenAI-compatible chat completions endpoint.

Authentication

Pass your gateway token as a Bearer token:

curl -H "Authorization: Bearer YOUR_TOKEN" http://localhost:18789/api/v1/status

Endpoints

Chat Completions (OpenAI-compatible)

POST /v1/chat/completions

Gateway Status

GET /api/v1/status

Sessions

GET /api/v1/sessions
GET /api/v1/sessions/:id
POST /api/v1/sessions/:id/message

Channels

GET /api/v1/channels
POST /api/v1/channels/:type/connect
DELETE /api/v1/channels/:type/disconnect

Skills

GET /api/v1/skills
POST /api/v1/skills/:id/install
DELETE /api/v1/skills/:id/uninstall