updateRole
put
/ccadmin/v1/roles/{id}
Update Role. Updates a given role by ID.
Request
Supported Media Types
- application/json
Path Parameters
-
id: string
The role ID.
Query Parameters
-
preview(optional): boolean
If set to true, updates a role for preview users. Defaults to false.
Root Schema : updateRole_request
Type:
Show Source
object
-
accessRights(optional):
array accessRights
Access rights to assign to role
-
description(optional):
string
Description of role
-
name(optional):
string
Name of role
Example:
{
"name":"Custom Role",
"description":"Custom Role",
"accessRights":[
{
"repositoryId":"customAccessRight1"
},
{
"repositoryId":"customAccessRight2"
}
]
}
Nested Schema : items
Type:
Show Source
object
-
repositoryId(optional):
string
Repository ID of access right
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Root Schema : getRole_response
Type:
Show Source
object
-
accessRights(optional):
array accessRights
Access rights assigned to role
-
description(optional):
string
Description of role
-
function(optional):
string
Function name for organizationRole
-
id(optional):
string
ID of role
-
name(optional):
string
Name of role
-
relativeTo(optional):
object relativeTo
Related organization for organizationRole
-
repositoryId(optional):
string
Repository ID of role
-
type(optional):
string
Type of role (role or organizationalRole)
Nested Schema : relativeTo
Type:
object
Related organization for organizationRole
Show Source
-
externalOrganizationId(optional):
string
External organization id
-
id(optional):
string
Repository ID of related organization
Nested Schema : items
Type:
Show Source
object
-
description(optional):
string
Description of access right
-
displayName(optional):
string
Display name of access right
-
id(optional):
string
ID of access right
-
name(optional):
string
Name of access right
-
repositoryId(optional):
string
Repository ID of access right
-
type(optional):
string
Type of access right
Example Response (application/json)
{
"name":"Custom Role",
"repositoryId":"customRole",
"description":"Custom Role",
"id":"customRole",
"accessRights":[
{
"displayName":"Custom Access Right 1",
"name":"Custom Access Right 1",
"repositoryId":"customAccessRight1",
"description":"Custom Access Right 1",
"id":"customAccessRight1",
"type":"generic"
},
{
"displayName":"Custom Access Right 2",
"name":"Custom Access Right 2",
"repositoryId":"customAccessRight2",
"description":"Custom Access Right 2",
"id":"customAccessRight2",
"type":"generic"
}
],
"type":"role"
}
412 Response
ETag mismatch. Asset has been updated by another user.
Default Response
The error response.
The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud:
|Error Code|Description|
|------------------|------------------|
|22048|If input passed is invalid|
|22100|If prohibited access rights are being added to an organization-based role|
|22101|If mandatory access rights are being removed from an organization-based role|
|22102|If an organization-based role is updated with global privileges
Root Schema : errorModel
Type:
Show Source
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
errors(optional):
array errors
An optional list of errors if multiple errors were encountered
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code
-
type(optional):
string
The URI to the HTTP state code definition
Nested Schema : errors
Type:
array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type:
Show Source
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code