Skip to content
Knobase

Management authentication

OAuth access tokens with the REST audience. Serving keys and setup tokens are rejected.

Caller identity and workspaces (grant ∩ membership).

  • Authorization: Bearer <management access token>
  • Audience must be knobase.management.rest. MCP tokens are rejected.
  • kb_… and kb_setup_… return TOKEN_CLASS_MISMATCH.
  • JWT workspace_ids is a hint. Runtime loads grant_id → active oauth_workspace_grant → membership + role + scopes.
  • Writes require Idempotency-Key. PATCH requires If-Match or version.

Docs version v1 · implemented publisher API