[{"label":"Latest (v1.0)","version":"latest"}]
csp
Patch Custom Role Permissions
DescriptionUpdate custom role’s permissions.
Access Policy
| Role | User Accounts | Service Accounts (Client Credentials Applications) |
|---|---|---|
| Organization Admin | ✔️ | ✔️ |
| Organization Owner | ✔️ | ✔️ |
Request
URLURL
https://{api_host}/csp/gateway/iam-roles-mgmt/api/orgs/{orgId}/custom-roles/{roleName}/permissions
Path Parameters
Path Parameters
string
orgId
Required
orgId
Parameter Serialization Style:
simple Explode:false
string
roleName
Required
Custom role’s name to update
Parameter Serialization Style:
simple Explode:false
Request Body
Request Body
UpdateRolePermissionsRequest
of mimetype application/json
Required
{
"permissionsToAdd": [
"string"
],
"permissionsToRemove": [
"string"
]
}
array of
string
permissionsToAdd
Optional
Permissions to add to role
array of
string
permissionsToRemove
Optional
Permissions to remove from role
Authentication
This operation uses the following authentication methods.
Response
Response
Response BodyResponse Body
200 OK
Returns
PartialSuccessResponseString
of type application/json
{
"failed": [
"string"
],
"succeeded": [
"string"
]
}
array of
string
failed
Optional
The entities for which the operation failed.
array of
string
succeeded
Optional
The entities for which the operation is successful.
Errors
CspErrorResponse
400
Invalid request body
CspErrorResponse
401
Unauthorized
CspErrorResponse
403
Forbidden
CspErrorResponse
404
Not Found
CspErrorResponse
409
The request could not be processed due to a conflict
CspErrorResponse
429
The user has sent too many requests
CspErrorResponse
500
An unexpected error has occurred while processing the request
Code Samples
cURL Command
curl -X PATCH -H "Content-Type: application/json" -d '{"permissionsToAdd":["string"],"permissionsToRemove":["string"]}' https://{api_host}/csp/gateway/iam-roles-mgmt/api/orgs/{orgId}/custom-roles/{roleName}/permissions
Vendor Extensions
This operation contains the following vendor extensions defined in the spec:
x-required-roles: org_admin,org_owner
x-slo-tier: TIER2
[{"label":"Latest (v1.0)","version":"latest"}]
csp
On This Page
Custom Roles Operations
post
delete
get
get
patch
