API ReferenceManagement

Permission Management

Overview

The Permissions Management APIs let you programmatically manage permissions using a management key.

Management keys are generated from Company > Management Keys. Include the key in the Authorization header as a bearer token in the format <Project ID>:<Management Key>.

Use Cases

  1. Load All Permissions
  2. Create Permission
  3. Update Permission
  4. Delete Permission

Examples

Example - create a permission and apply it to a role

  1. Call the Create Permission API endpoint to create a new permission.
  2. Use the Create Role or Update Role API endpoints to apply the permission to a role.
Was this helpful?

Update Tenant Default Roles POST

Update tenant default roles, using a valid management key.

Load All Permission GET

### Load all permissions, using a valid management key. This API endpoint returns details all permissions configured within the Descope instance. The response includes an array of permissions and these details of each permission: - name - description - systemDefault ### Next Steps Once you have this data, you can utilize the response to [Create Roles](/api/management/roles/create-role) or [Update Roles](/api/management/roles/update-role) ### See also - See [User Authorization](/manage/roles/) for further details on managing roles and permissions.

On this page

Permission ManagementOverviewUse CasesExamplesExample - create a permission and apply it to a role