Performs an on-demand quarantine action on specific resources such as removing from quarantine, excluding from quarantine, or extending the exclusion period
put /dcapi/compliance/quarantine/onDemand
https://{serverurl}/dcapi/compliance/quarantine/onDemand
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
List of resource IDs to perform the on-demand action on
Action type: removeFromQuarantine, doNotQuarantine, removeFromExclusionList, or extendExclusionList
Number of days for exclusion period (required for removeFromQuarantine, doNotQuarantine, extendExclusionList)
curl --request PUT \
--url https://appdomains/dcapi/compliance/quarantine/onDemand \
--header 'Accept: application/onDemandQuarantineAction.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/onDemandQuarantineAction.v1+json' \
--data '{}'Remove selected resources from quarantine isolation
{
"onDemandAction": "removeFromQuarantine",
"days": "7",
"resourceIds": [
"1001",
"1002",
"1003"
]
}
Extend grace period for pending quarantine resources
{
"onDemandAction": "doNotQuarantine",
"days": "14",
"resourceIds": [
"1001"
]
}
Remove resources from the exclusion list to re-quarantine them
{
"onDemandAction": "removeFromExclusionList",
"resourceIds": [
"1001",
"1002"
]
}
Extend the exclusion period for already-excluded resources
{
"onDemandAction": "extendExclusionList",
"days": "30",
"resourceIds": [
"1001"
]
}
Operation result. success on successful action
Human-readable message describing the action taken
HTTP status code (400)
API-specific error code identifying the validation failure
Error message describing the validation failure
Unauthorized error code: credentials missing, expired, or invalid
Authentication failure reason
Forbidden error code indicating user lacks ALL_MANAGED_COMPUTER_ROLE permission
Message indicating user must have permissions to manage all computers
Rate limit error code returned when the API call reached threshold
Rate limit exceeded message with retry guidance
Resources removed from quarantine
{
"message": "Selected system(s) have been removed from Quarantine successfully",
"status": "success"
}
Grace period extended for resources
{
"message": "Selected system(s) have been extended from grace period successfully",
"status": "success"
}
Resources removed from exclusion list
{
"message": "Selected system(s) have been removed from exclusion successfully",
"status": "success"
}
Exclusion period extended for resources
{
"message": "Selected system(s) have been extended from exclusion successfully",
"status": "success"
}
A request body parameter has an invalid format or type
{
"errorCode": "IAM0025",
"url": "/dcapi/compliance/quarantine/onDemand",
"errorMsg": "resourceIds is an invalid parameter format."
}
Authentication credentials are missing or invalid
{
"errorMessage": "Authentication required",
"errorCode": "UNAUTHORIZED"
}
User lacks ALL_MANAGED_COMPUTER_ROLE permission
{
"errorMessage": "Verify if the user is granted permissions to manage all computers!",
"errorCode": "RESOURCE_NOT_IN_SCOPE"
}
Quarantine is not available in VMP Professional Edition
{
"errorMessage": "You do not have enough permission to perform this action. Upgrade to Enterprise Edition to use these features.",
"errorCode": "FORBIDDEN"
}
API call threshold exceeded
{
"errorMessage": "Rate limit exceeded. Retry after some time",
"errorCode": "TOO_MANY_REQUESTS"
}
![]()
Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.