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
- Sign in on the web as a workspace admin.
- Settings → API → Create key.
- Copy the bk_live_ value once; it is not shown again.
- 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.
