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 — organization base data.
- GET /v1/[org]/channels — channel list with status and visibility.
- GET /v1/[org]/sessions — broadcasts with filters by status and time range.
- GET /v1/[org]/questions — incoming Q&A with status.
- GET /v1/[org]/announcements — announcements from current and past broadcasts.
- GET /v1/[org]/reactions — aggregated reaction counts by type.
- GET /v1/[org]/analytics/overview — statistics overview for the organization.
04
Rate limits
Every response includes the X-RateLimit-Remaining header with the remaining quota. On overflow the API replies with 429 Too Many Requests and a Retry-After header.
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 — organization base data.
- GET /v1/[org]/channels — channel list with status and visibility.
- GET /v1/[org]/sessions — broadcasts with filters by status and time range.
- GET /v1/[org]/questions — incoming Q&A with status.
- GET /v1/[org]/announcements — announcements from current and past broadcasts.
- GET /v1/[org]/reactions — aggregated reaction counts by type.
- GET /v1/[org]/analytics/overview — statistics overview for the organization.
04
Rate limits
Every response includes the X-RateLimit-Remaining header with the remaining quota. On overflow the API replies with 429 Too Many Requests and a Retry-After header.
05
Full reference
The interactive reference with every endpoint, query parameter and response schema:
Open API reference

Create an API token