API Reference/Management/Roles
POST
/v1/mgmt/role/search

Authorization

AuthorizationRequiredBearer <token>

< Project ID >:< Management Key > as bearer

In: header

Request Body

application/jsonRequired
tenantIdsarray<string>
roleNamesarray<string>
roleNameLikestring
permissionNamesarray<string>
textstring

Full text search across relevant columns

sortarray<object>
curl -X POST "https://api.descope.com/v1/mgmt/role/search" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "tenantIds": [
      "string"
    ],
    "roleNames": [
      "string"
    ],
    "roleNameLike": "string",
    "permissionNames": [
      "string"
    ],
    "text": "string",
    "sort": [
      {
        "field": "string",
        "desc": true
      }
    ]
  }'

OK

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

Was this helpful?

Next

Load All Roles GET

Next

Create Role POST