API ReferenceManagementRoles
POST
/v1/mgmt/role/create

Create a role, using a valid management key.

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

  • name (required)
  • description (optional)
  • permissionNames (optional)

See also

Endpoint Authentication

Use authorization bearer header with the following format:

Authorization: Bearer \<ProjectId:ManagementKey\>

Try it

/v1/mgmt/role/create

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

< Project ID >:< Management Key > as bearer

In: header

Request Body

namestring

descriptionstring

permissionNamesarray<string>

tenantIdstring

Status codeDescription
200OK
curl -X POST "https://api.descope.com/v1/mgmt/role/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <ProjectId:ManagementKey>" \
  -d '{
  "name": "string",
  "description": "string",
  "permissionNames": [
    "string"
  ],
  "tenantId": "string"
}'

{
  "name": "string",
  "description": "string",
  "permissionNames": [
    "string"
  ],
  "createdTime": 0,
  "tenantId": "string"
}

Was this helpful?

Previous

Search Roles

Next

Update Role