Revoke multiple permissions on an agent
DELETE
/api/v2/agents/{agent_id}/permissions/batch
This endpoint is useful when you need to remove multiple users or teams from an agent at once, such as when offboarding team members or restructuring access.
Request
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request DELETE 'https:///api/v2/agents//permissions/batch' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer 'Response Response Example
200 - Example 1
{
"success": true,
"message": "string",
"data": {
"agent_id": 0,
"revoked": [
{
"subject_type": "string",
"subject_id": "string",
"subject_name": "string",
"revoked_relations": [
"string"
]
}
],
"failed": [
{
"subject_type": "string",
"subject_id": "string",
"subject_name": "string",
"error": "string"
}
],
"revoked_at": "2019-08-24T14:15:22.123Z"
}
}