API ReferenceManagementRoles
POST
/v1/mgmt/role/delete

Delete a role, using a valid management key.

This API endpoint allows administrators to delete an existing role. The endpoint takes the following one parameter:

  • name (required)

See also

  • See User Authorization for further details on managing roles and permissions._override/App.tsx

Endpoint Authentication

Use authorization bearer header with the following format:

Authorization: Bearer \<ProjectId:ManagementKey\>

Try it

/v1/mgmt/role/delete

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

< Project ID >:< Management Key > as bearer

In: header

Request Body

namestring

tenantIdstring

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

Previous

Update Role

Next

Batch Delete Roles