Help

API keys

Create, rotate, and revoke BetterKnocks API keys for REST and MCP integrations.

  • Step-by-step
  • Web + mobile
  • Free to start

API keys are workspace-scoped secrets for the REST API and MCP server. Pro and above for API; Elite for MCP.

Create a key

  1. Sign in on the web as a workspace admin.
  2. Settings → API → Create key.
  3. Copy the bk_live_ value once; it is not shown again.
  4. Store in your secrets manager, not in a repo.

Use the key

  • REST: X-API-Key: bk_live_... on every request to /api/v1/...
  • MCP: BETTERKNOCKS_API_KEY env var in Cursor config
  • See /developers/api for endpoints

Rotate and revoke

Create a new key, update integrations, then revoke the old key in settings. Revoke immediately if a key leaks.