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://{server-hostname}:8383/dcapi/compliance/quarantine/onDemand
VulnerabilityMgmt.UPDATECopied!
Authorization: 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://appdomain/dcapi/compliance/quarantine/onDemand \
--header 'Accept: application/onDemandQuarantineAction.v1+json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/onDemandQuarantineAction.v1+json' \
--data '{"onDemandAction":"removeFromQuarantine","days":"7","resourceIds":["1001","1002","1003"]}'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 returned when authentication credentials are missing, expired, or invalid (authentication=required)
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 threshold (configured via threshold/duration in security XML) is exceeded; client is locked out for lock-period minutes
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.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.