Revoke a role from a user

​

Revoke a specific role assignment from a user.

Entity Authorization:

  • Defaults to current user's entity if entityId not provided
  • Cross-entity revocation requires hierarchy access (parent can revoke in child entities)
  • Requires role:delete permission in the target entity
Path Parameters
  • userId
    Type: stringFormat: uuid
    required

    User ID (UUID)

  • roleName
    Type: string
    required

    Role name to revoke

Query Parameters
  • entityId
    Type: stringFormat: uuid

    Entity scope filter (defaults to current user's entity). Requires hierarchy access for cross-entity revocations.

  • resourceGroupId
    Type: stringFormat: uuid

    Resource group scope filter

Responses
  • 204

    No Content (204) - Operation completed successfully with no response body

  • application/json
  • 403

    Forbidden - No access to target entity or insufficient permissions

  • application/json
Request Example for delete/users/{userId}/roles/{roleName}
curl 'https://api.gpcn.com/v1/users/123e4567-e89b-12d3-a456-426614174000/roles/{roleName}?entityId=&resourceGroupId=' \
  --request DELETE \
  --header 'X-API-Key: YOUR_SECRET_TOKEN'
No Body

No Content (204) - Operation completed successfully with no response body