# Decline Specified Patches

Initiates the decline action for the specified patches across all managed systems.

**This API endpoint is deprecating soon**

This API endpoint will be permanently removed on October 2026, please migrate to the new endpoint.

## Endpoint

`POST /api/1.4/patch/declinepatch`

## Request URL

`https://{serverurl}/api/1.4/patch/declinepatch`

## Scope

`DesktopCentralCloud.PatchMgmt.CREATE`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Query Parameters

- `customerid` — long, optional

### Request Body

`application/json`

- JSON Object
  - `patchids` — array, mandatory
    - Array of patch IDs to decline. Max 1000 entries.

## Sample Request

```curl
curl --request POST \
  --url https://appdomains/api/1.4/patch/declinepatch \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52' \
  --header 'content-type: application/json' \
  --data '{"patchids":[112,113]}'
```

## Sample Request Body

Decline patches by IDs

```json
{
  "patchids": [
    112,
    113
  ]
}
```

## Response Parameters

### HTTP Code 200

Response Body — `application/json`

- JSON Object
  - `message_type` — string
    - Action identifier: declinepatch
  - `message_response` — JSON Object
    - Decline result payload
  - `message_version` — string
    - API version: 1.4
  - `status` — string
    - Overall operation 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

## Possible Response Codes

- `200` — HTTP code
- `400` — HTTP code

## Sample Response: HTTP 200

Decline initiated successfully

```json
{
  "message_type": "declinepatch",
  "message_response": {
    "declinepatch": {
      "status": "Initiated Successfully"
    }
  },
  "message_version": "1.4",
  "status": "success"
}
```

## Sample Response: HTTP 400

### User Lacks All Managed Computer Role

```json
{
  "error_description": "Verify if the user is granted permissions to manage all computers!",
  "error_code": "DECLINE_FAILED_CODE",
  "error": "DECLINE_FAILED"
}
```

### No Patch IDs Provided in Request

```json
{
  "error_description": "No Patches Specified",
  "error_code": "DECLINE_FAILED_CODE",
  "error": "DECLINE_FAILED"
}
```

## Rate Limit

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**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.