Remove role from user
You can remove a role from a user by using the following endpoint.
HTTP request
DELETE https://$instanceId.id.nevis.cloud/nevis/api/v1/users/$userId/authorizations/$authorizationId
Parameters
Parameter | In | Type | Required / Optional | Description |
---|---|---|---|---|
instanceId | path | string | required | The ID of your Identity Cloud instance. |
userId | path | string | required | The ID of the user. |
authorizationId | path | string | required | The ID of the authorization. |
Example request
userId=948ce1fd-9fb4-4ae2-a9d2-70e229b121ed
authorizationId=a229a329-2e28-4005-9760-16cd280d6f0d
curl --request DELETE "https://$instanceId.id.nevis.cloud/nevis/api/v1/users/$userId/authorizations/$authorizationId" \
--header "Authorization: Bearer $accessKey"
HTTP response
On success
HTTP/1.1 204
is returned if the role is successfully removed from the user.
On missing user
HTTP/1.1 404
is returned if the user with the given userId
is not found.
On missing authorization
HTTP/1.1 404
is returned if the authorization with the given authorizationId
is not found.
On failure
HTTP/1.1 401
is returned if the authorization fails due to an invalid access key.
HTTP/1.1 422
is returned if invalid request content is given.
HTTP/1.1 500
is returned if an unexpected error occurs.