Detach permission policies of a role
POST /api/roles/{role_id}/detach_permission_policies
POST /api/roles/{role_id}/detach_permission_policiesInteractive request editor loads with JavaScript.
X-API-KEY<token>
In: header
Path Parameters
role_id*string
Role ID.
Length
1 <= lengthRequest Body
application/json
An array of permission policy ID.
[index: integer]?string
Response Body
application/json
application/json
curl -X POST "$API_BASE_URL/api/roles/4b9b56d1-147e-49ef-bcaa-88cc5bcf403f/detach_permission_policies" \ -H "Content-Type: application/json" \ -d '[ "efd3bcc7-b61a-47ec-942b-b36bf249f1da" ]'Successful operation.
{
"value": {}
}Bad Request — The request was malformed or contained invalid parameters. Check the error_msg field for details.
{
"value": {},
"error_msg": "error message"
}Complete operation details and schema variants
POST /api/roles/{role_id}/detach_permission_policies
Detach permission policies of a role
Detach permission policies from a role. Removing policies may reduce or revoke access for assigned users.
Required IAM Permission: Action iam:UpdateRole, Resource arn:api7:iam:role/%s
Parameters
role_id(path, string, required): Role ID.
Request body
Content type: application/json
Responses
200: Successful operation.value(object, optional): The specific resource.400: Bad Request — The request was malformed or contained invalid parameters. Check the error_msg field for details.value(object, optional): The specific resource.error_msg(string, optional): The error message.
cURL
curl -X POST '$API_BASE_URL/api/roles/{role_id}/detach_permission_policies'