API Reference/Management/Roles
GET
/v1/mgmt/role/all

Authorization

AuthorizationRequiredBearer <token>

< Project ID >:< Management Key > as bearer

In: header

curl -X GET "https://api.descope.com/v1/mgmt/role/all" \
  -H "Authorization: Bearer <token>"

OK

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

Was this helpful?

Role Management API Overview

Use the Descope API to create, manage, and delete roles using a management key.

Search Roles POST

### Search roles, using a valid management key. This API endpoint allows administrators to search against existing roles. This endpoint returns an array of roles including their name, description, and permissionsNames that match the search parameters. ### See also - See [User Authorization](/manage/roles/) for further details on managing roles and permissions. ### Endpoint Authentication Use authorization bearer header with the following format: `Authorization: Bearer <ProjectId:ManagementKey>`