Skip to main content
A restricted key is an API credential with module-level permissions. Use one for each application or integration so it can only reach the resources it needs, for example read access to Payments and no access to Customers.

Permissions

Each permission pairs a module with a permission_level.

Create a restricted key

POST /api/v1/restricted-keys
The secret_key is shown only once. Store it securely. It can’t be retrieved or shown again.

Retrieve a restricted key

GET /api/v1/restricted-keys/{id} Returns the key’s details and its permission for every module.

Update a restricted key

PUT /api/v1/restricted-keys/{id} Updates the name or module permissions.

List restricted keys

GET /api/v1/restricted-keys

Delete a restricted key

DELETE /api/v1/restricted-keys/{id} Deletes the key immediately. Any request using it stops working straight away.
Last modified on November 10, 2026