Get users with a certain role

get

/ec-auth-svc/rest/v1.0/users/role/{role}

Returns all users assigned to a specified global role. The 'role' parameter should match an existing global role name exactly. Each user object includes an ID, first and last name, username, and email address.

Request

Path Parameters
  • The role name to look up users for (case-sensitive, must match an existing role).
    Example:
    APPROVE_LIBRARY_OBJECTS

There's no request body for this operation.

Back to Top

Response

Supported Media Types

200 Response

Success
Body ()
Root Schema : schema
Type: array
Show Source
Nested Schema : DisplayUserDto
Type: object
User details including name, username, and email address.
Show Source
Examples

400 Response

Bad request
Body ()
Root Schema : AuthResponse
Type: object
Generic API response wrapper containing result, error data, response version and status.
Show Source
Nested Schema : ErrorResponseData
Type: object
Structure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
Show Source
  • Detailed error context or debugging information such as validation error, stack trace, or field/parameter cause.
    Example: User role is missing required permission REPORTING_VIEW. Field: userId
  • Application or business-specific error code representing the error type.
    Example: REPT_401
  • Human-readable error message describing the failure or issue.
    Example: Unauthorized: User does not have access to the requested resource
Nested Schema : result
Type: object
Result data of the API response; actual type depends on the API
Example:
oracle.doceng.json.BetterJsonNull@3565a0f5
Back to Top