API key is missing, expired, revoked, or lacks permission
API keys are shown raw exactly once, store only a hash server-side, carry explicit scopes, and can have an expiry.
What you may be seeing
- An integration gets authentication/permission errors or the user cannot recover the raw key from Settings.
What usually causes it
- The raw key was not stored when created and cannot be displayed again.
- The key expired/revoked.
- The key lacks the required resource scope.
- The plan lacks api_access for minting a new key.
Do this
- Open Settings → Developer and inspect the key row for scopes, expiry and revoked status.
- If the raw secret was lost, mint a new key; CanvasRelay intentionally cannot reveal an existing raw key because only its hash is stored.
- Choose the minimum scopes the integration needs and store the new crk_ value immediately.
- Revoke superseded keys after the integration is moved to the replacement.
You know it is fixed when
- The integration authenticates with the new/valid scoped key and the key's last-used value updates after use.
Search phrases this guide covers
lost API key · crk key · key revoked · key expired · scope denied · create API key
