# Download Specified Patches

Downloads specified patches to the patch store with option to force download if already downloaded.

## Endpoint

**POST** `/dcapi/patch/downloads`

## Request

### Request URL

`https://{server-hostname}:8383/dcapi/patch/downloads`

### Scope

`PatchMgmt.CREATE`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Body

`application/json`

**JSON Object**

- **patchIds** `array` — **Mandatory**
  - Array of patch IDs to download
- **forceDownload** `boolean` — Optional
  - Force redownload even if already downloaded

### Sample Request

```curl
curl --request POST \
  --url https://appdomain/dcapi/patch/downloads \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'content-type: application/json' \
  --data '{"patchIds":[12345,12346,12347],"forceDownload":false}'
```

### Sample Request Body

#### Download specific patches

```json
{
  "patchIds": [
    12345,
    12346,
    12347
  ],
  "forceDownload": false
}
```

#### Force redownload failed patches

```json
{
  "patchIds": [
    12345
  ],
  "forceDownload": true
}
```

## Response Parameters

### HTTP Code 200

Response Body — `application/json`

**JSON Object**

- **status** `string`
  - Download operation status: Download initiated
- **patchCount** `string`
  - Number of patches queued for download

## Possible Response Codes

- **200** — HTTP code

## Sample Response: HTTP 200

### Download started

```json
{
  "patchCount": 3,
  "status": "Download initiated"
}
```

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