Authentication

All public endpoints except healthcheck require an API token.
X-API-Key: <api_token>

Getting an API key

API keys are currently issued by the administrator. Contact: @iambatashev

Access control

Each API key has a list of allowed scopes. If the key is missing a required scope, the API returns 403.

Scopes

ScopeAccess
messages.readSource metadata and source messages
search.readSemantic message search
summary.runChat and channel summaries
message.sendOutbound message sending
workflow.manageReserved for workflow routes, currently not public

Missing or invalid token

{
  "status": 401,
  "detail": "Missing API key.",
  "error_code": "auth.api_key_missing",
  "extra": null
}