Get user role assignments

​

Get roles assigned to a specific user, filtered by entity.

Entity Authorization:

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

    User ID (UUID)

Query Parameters
  • entityId
    Type: stringFormat: uuid

    Filter roles by entity (defaults to current user's entity). Requires hierarchy access for cross-entity queries.

Responses
  • application/json
  • application/json
  • 403

    Forbidden - No access to target entity or insufficient permissions

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

{
  "success": true,
  "message": "string",
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "string",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "resourceGroupId": "123e4567-e89b-12d3-a456-426614174000"
    }
  ],
  "meta": null
}

User roles retrieved successfully