BramaPay Docs

API Keys

Create, store, and revoke project-bound credentials.

MethodPathAuthPurpose
POST/api-keysDashboard JWT + X-Project-IdCreate a key pair
GET/api-keysDashboard JWT + X-Project-IdList key metadata, never secrets
DELETE/api-keys/:idDashboard JWT + X-Project-IdRevoke a key

Creation returns a pk_live_... public identifier and an sk_live_... secret once. The current /v1/invoices API accepts only the secret key and provides project-level access; no finer named scopes are exposed.

To rotate safely, create and deploy a new key, verify traffic, then revoke the old key. Revocation is immediate for new authentication attempts.