API access

01
Create an API token
Under Organization → API tokens you generate tokens for programmatic access to org data. Per token you set:
- Label for recognition.
- Validity: 30, 90, 365 days or unlimited.
- Access: currently read-only.
Heads up
Tokens are shown only once. Copy them right after creation. Maximum 5 active tokens per organization.
02
Authentication
Tokens are passed in the Authorization header:
```
curl https://api.openbooth.io/v1/[orgSlug]/channels \
  -H "Authorization: Bearer obk_..."
```
Paths include the org slug: /v1/[orgSlug]/[resource].
03
Key endpoints
- GET /v1/[org] - organization profile, settings and plan.
- GET /v1/[org]/team - organization members.
- GET /v1/[org]/subscription - plan, limits and AI funding (wallet or BYOK).
- GET /v1/[org]/channels - channel list with status and visibility.
- GET /v1/[org]/channels/[channel]/sessions - broadcasts of a channel, filterable by status and time range.
- GET /v1/[org]/sessions/[id] - session detail plus sub-resources: questions, announcements, reactions, speakers, ai.
04
Rate limits
The API allows up to 300 requests per minute per IP address. On overflow it replies with 429 Too Many Requests plus a Retry-After header indicating the seconds to wait.
05
Full reference
The interactive reference with every endpoint, query parameter and response schema:
Open API reference

01
Create an API token
Under Organization → API tokens you generate tokens for programmatic access to org data. Per token you set:
- Label for recognition.
- Validity: 30, 90, 365 days or unlimited.
- Access: currently read-only.
Heads up
Tokens are shown only once. Copy them right after creation. Maximum 5 active tokens per organization.
02
Authentication
Tokens are passed in the Authorization header:
```
curl https://api.openbooth.io/v1/[orgSlug]/channels \
  -H "Authorization: Bearer obk_..."
```
Paths include the org slug: /v1/[orgSlug]/[resource].
03
Key endpoints
- GET /v1/[org] - organization profile, settings and plan.
- GET /v1/[org]/team - organization members.
- GET /v1/[org]/subscription - plan, limits and AI funding (wallet or BYOK).
- GET /v1/[org]/channels - channel list with status and visibility.
- GET /v1/[org]/channels/[channel]/sessions - broadcasts of a channel, filterable by status and time range.
- GET /v1/[org]/sessions/[id] - session detail plus sub-resources: questions, announcements, reactions, speakers, ai.
04
Rate limits
The API allows up to 300 requests per minute per IP address. On overflow it replies with 429 Too Many Requests plus a Retry-After header indicating the seconds to wait.
05
Full reference
The interactive reference with every endpoint, query parameter and response schema:
Open API reference

Create an API token