Update a global user's roles
put
/ec-auth-svc/rest/v1.0/globalusers/{userid}/roles
Assign or update the list of global roles for a given user.
Request body is a JSON array of role UUIDs. Each UUID must be a 32-character hexadecimal value corresponding to a global role. Returns the newly assigned global roles for the user.
Request
Path Parameters
-
userid(required): string(uuid)
User ID.Example:
94A7C1C2049A4C1590AB52F757AD25A3
Query Parameters
-
localize: boolean
Default Value:
false
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
array-
Array of:
string(uuid)
Example:
821DEE0FC2204E7A86BCC65A597F7815
Examples
Back to Top
Response
Supported Media Types
- application/json
200 Response
Success
Root Schema : schema
Type:
Show Source
array-
Array of:
object DisplayUserRoleDto
Associates a user with a global role.
Nested Schema : DisplayUserRoleDto
Type:
objectAssociates a user with a global role.
Show Source
-
id: string
(uuid)
Unique identifier for this user-role association.
-
roleName: string
Name of the role assigned to the user.Example:
STUDY_MANAGER
Example:
{
"id":"A519EF3C2B73455390CFF812AFF61519",
"roleName":"STUDY_MANAGER"
}Examples
400 Response
Bad request
Root Schema : AuthResponse
Type:
objectGeneric API response wrapper containing result, error data, response version and status.
Show Source
-
errorData: object
ErrorResponseData
Structure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
-
result: object
result
Result data of the API response; actual type depends on the API
-
status: string
(none)
Indicates request success ("success") or failure ("failure").Example:
success -
version: integer
(int32)
Version of the response schema.Example:
1
Nested Schema : ErrorResponseData
Type:
objectStructure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
Show Source
-
details: string
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 -
errorCode: string
Application or business-specific error code representing the error type.Example:
REPT_401 -
errorMessage: string
Human-readable error message describing the failure or issue.Example:
Unauthorized: User does not have access to the requested resource
Nested Schema : result
Type:
objectResult data of the API response; actual type depends on the API
Example:
oracle.doceng.json.BetterJsonNull@3565a0f5