Skip to content

Pods

Group inboxes for tenant isolation and issue pod-scoped API keys.

01

Create a pod#

The response includes a pod-scoped API key exactly once.

Shell
curl https://botinbox.dev/v0/pods -X POST -H "Authorization: Bearer $BOTINBOX_API_KEY" \
  -H "Content-Type: application/json" -d '{"name":"Acme tenant"}'

02

Scope resources#

Pass pod_id while creating an inbox. A pod key can list and use only inboxes assigned to its pod, and can read only its own pod via GET /v0/pods/:podId. Listing or creating pods requires an account key; out-of-scope requests return 403.