Remove groups from a role

Unassign one or more groups from a specified role.

DELETE https://{tenantDomain}/api/v2/roles/{id}/groups

Remove groups from a role

cURL

curl --request DELETE \
  --url https://{tenantDomain}/api/v2/roles/{id}/groups \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "groups": [
    "<string>"
  ]
}
'

Autorisations

bearerAuthoAuth2ClientCredentials

Authorization · string · header · requis

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Paramètres de chemin

id · string · requis

Unique identifier for the role (service-generated).

Corps

application/jsonapplication/x-www-form-urlencoded

groups · string[] · requis

Array of group IDs to remove from the role.

Minimum array length: 1

Unique identifier for the group (service-generated).

Required string length: 18 - 26

Pattern: ^grp_[1-9a-km-zA-HJ-NP-Z]{14,22}$

Réponse

204

Groups successfully removed from role.