Skip to content

REST and curl

Call BotInbox from any language with standard HTTP and JSON.

01

Base URL and errors#

All endpoints live under https://botinbox.dev/v0 and take Authorization: Bearer bi_your_key. Success bodies are JSON except attachment downloads and 204 deletes. Errors return JSON with an error message and, for most failures, a machine-readable code, with a matching 4xx/5xx status.

02

OpenAPI#

Generate clients or import the API into tools from /v0/openapi.json.

Shell
curl https://botinbox.dev/v0/openapi.json