Deletes an existing Automated Patch Deployment (APD) task.
delete /dcapi/patch/autopatchdeployment/delete
https://{serverurl}/dcapi/patch/autopatchdeployment/delete Copied!
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
ID of the APD task. Get the task IDs from Get APD Tasks api
curl --request DELETE \
--url https://appdomains/dcapi/patch/autopatchdeployment/delete \
--header 'Accept: application/deletetask.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/deletetask.v1+json' \
--data '["9502000000081045"]'Delete a single APD task
[
"9502000000081045"
]
Delete several APD tasks in one call
[
"9502000000081045",
"9502000000081061"
]
Identifier of the APD task, used as the key. The value is true when the action succeeded for that task and false when it did not.
Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required)
Authentication failure reason
Forbidden error code returned when the authenticated user does not have the required uem-roles (e.g., DataEncryption_Admin or DataEncryptionRecoveryKey_Admin)
Message indicating insufficient privileges to access this resource
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
The task was deleted successfully
{
"9502000000081045": true
}
One task was deleted, the other was not
{
"9502000000081045": true,
"9502000000081061": false
}
Authentication credentials are missing, expired or invalid
{
"error_code": "UAC_UNAUTHORIZED",
"error_description": "dc.rest.authentication.unauthorized"
}
Authenticated user lacks the required role or scope
{
"errorCode": "FORBIDDEN",
"errorMessage": "You do not have sufficient privileges to perform this operation"
}
API call threshold exceeded
{
"errorCode": "RATE_LIMIT_EXCEEDED",
"errorMessage": "API call limit exceeded. Retry after the lock period elapses"
}
![]()
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.