Threa Public API

The Threa Public API lets you programmatically read and write messages, list streams, search, and more. ## Authentication All requests require a Bearer token in the `Authorization` header: ``` Authorization: Bearer thr_your_api_key_here ``` API keys are created by **workspace admins** in the Threa app under **Settings > API Keys**. Each key is scoped to a workspace and granted specific permissions (scopes). ## Scopes API keys are granted specific scopes that control access: - `messages:search` — Grants access to search messages in public streams in a workspace. Application level stream grants can extend permissions to private streams. - `streams:read` — Grants access to list and search accessible streams in a workspace. - `messages:read` — Grants access to read messages in accessible streams. - `messages:write` — Grants access to send, update, and delete messages in accessible streams. - `users:read` — Grants access to list and search workspace users. ## Rate Limits Requests are rate-limited per workspace and per API key. Rate limit headers are included in responses. ## Pagination List endpoints return paginated results with `hasMore` and `cursor` fields. Pass the `cursor` value as the `after` query parameter to fetch the next page.