Permission Management
Overview
Using the permissions management APIs enables administrators to manage their permissions utilizing a management key.
Management keys are generated from Company > Management Keys. These keys will be used within the bearer token. The format is <Project ID>:<Management Key>.
Use Cases
SSO Management:
- Load All Permissions
- Create Permission
- Update Permission
- Delete Permission
Examples
Example - Configure a new permission and apply it to a role
- Utilize the Create Permission api endpoint to create a new permission.
- Utilize the Create Role or Update Role api endpoints to apply the permission to a role.
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.