POST
/v1/mgmt/permission/create

Create a permission, using a valid management key.

This API endpoint allows administrators to create a new permission. The endpoint takes the following two parameters:

  • name (required)
  • description (optional)

Next Steps

Once you have this data, you can utilize the newly created role to Create Roles or Update Roles

See also

Endpoint Authentication

Use authorization bearer header with the following format:

Authorization: Bearer \<ProjectId:ManagementKey\>

Try it

/v1/mgmt/permission/create

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

< Project ID >:< Management Key > as bearer

In: header

Request Body

namestring

descriptionstring

Status codeDescription
200OK
curl -X POST "https://api.descope.com/v1/mgmt/permission/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <ProjectId:ManagementKey>" \
  -d '{
  "name": "string",
  "description": "string"
}'
Was this helpful?