# Initiate Decline Patch Action Initiates the decline action for the specified patches across all managed systems. **This API endpoint is deprecating soon** ## Endpoint `POST /api/1.4/patch/declinepatch` ## Request URL `https://`[*{serverurl}*](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)`/api/1.4/patch/declinepatch` ## Scope `DesktopCentralCloud.PatchMgmt.CREATE` ### Header `Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52` ## Request Parameters ### Request Headers #### Content-Type `string` · **Mandatory** · `application/json` #### Accept `string` · **Mandatory** · `application/json` ### Query Parameters #### customerid `long` · Optional Applicable only for MSP editions. A unique identifier of the customer on whom the action needs to be performed. Get the customer ID from the [Customer Details](https://www.manageengine.com/products/desktop-central/help/api/cloud/getallcustomers.html) API. ### Request Body `application/json` `JSON Object` #### patchids `array` · Optional Patch IDs to act on. Get the patch IDs from the [Get All Patches](https://www.manageengine.com/products/desktop-central/help/api/cloud/patch-report-legacy-get-all-patches.html) API. ### Sample Request ```curl curl --request POST \ --url https://appdomains/api/1.4/patch/declinepatch \ --header 'Accept: application/json' \ --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \ --header 'Content-Type: application/json' \ --data '{}' ``` ### Sample Request Body ```json { "patchids": [ 112, 113 ] } ``` ## Response Parameters ### HTTP Code 200 Response Body — `application/json` `JSON Object` #### message_type `string` Value: `declinepatch` #### message_response `object` Decline result containing status message. #### message_version `string` API version: `1.4` #### status `string` Operation status: `success` ### Sample Response: HTTP 200 ```json { "message_type": "declinepatch", "message_response": { "declinepatch": { "status": "Initiated Successfully" } }, "message_version": "1.4", "status": "success" } ``` ### HTTP Code 400 Response Body — `application/json` `JSON Object` #### error_code `string` Error code: `DECLINE_FAILED_CODE` for decline failures. #### error `string` Error type: `DECLINE_FAILED` #### error_description `string` Detailed failure reason: insufficient permissions, invalid patch list, or empty patches. ### Sample Response: HTTP 400 User lacks All Managed Computer role ```json { "error_code": "DECLINE_FAILED_CODE", "error": "DECLINE_FAILED", "error_description": "Verify if the user is granted permissions to manage all computers!" } ``` No patch IDs provided in request ```json { "error_code": "DECLINE_FAILED_CODE", "error": "DECLINE_FAILED", "error_description": "No Patches Specified" } ``` ### HTTP Code 401 Response Body — `application/json` `JSON Object` #### errorCode `long` Unauthorized error code returned when authentication credentials are missing, expired, or invalid (`authentication=required`). #### errorMsg `string` Authentication failure reason. ### Sample Response: HTTP 401 Authentication credentials are missing, expired or invalid ```json { "error_code": "UAC_UNAUTHORIZED", "error_description": "dc.rest.authentication.unauthorized" } ``` ### HTTP Code 403 Response Body — `application/json` `JSON Object` #### errorCode `long` Forbidden error code returned when the authenticated user does not have the required uem-roles (for example, `DataEncryption_Admin` or `DataEncryptionRecoveryKey_Admin`). #### errorMsg `string` Message indicating insufficient privileges to access this resource. ### Sample Response: HTTP 403 Authenticated user lacks the required role or scope ```json { "errorCode": "FORBIDDEN", "errorMessage": "You do not have sufficient privileges to perform this operation" } ``` ### HTTP Code 429 Response Body — `application/json` `JSON Object` #### errorCode `long` 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. #### errorMsg `string` Rate limit exceeded message with retry guidance. ### Sample Response: HTTP 429 API call threshold exceeded ```json { "errorCode": "RATE_LIMIT_EXCEEDED", "errorMessage": "API call limit exceeded. Retry after the lock period elapses" } ``` ## Rate Limits **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.