# List APD Tasks

Retrieves a paginated list of Automated Patch Deployment tasks with their configuration details, target counts, and schedule information.

**This API endpoint is deprecating soon**

## Endpoint

`GET /api/1.4/patch/apdTaskListdetails`

## Request

### Request URL

`https://{server-hostname}:8383/api/1.4/patch/apdTaskListdetails`

### Scope

`PatchMgmt.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Sample Request

```curl
curl --request GET \
  --url https://appdomain/api/1.4/patch/apdTaskListdetails \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

Response Body: `application/json`

- JSON object
  - `message_type` (string): Action identifier: apdTaskListdetails
  - `message_response` (JSON object): APD task list response payload with pagination
  - `message_version` (string): API version: 1.3
  - `status` (string): Overall operation status: success

### Possible Response Codes

- `200` (HTTP code)

### Sample Response: HTTP 200

Paginated APD task list with two tasks

```json
{
  "message_type": "apdTaskListdetails",
  "message_response": {
    "total": 2,
    "apdtasklistdetails": [
      {
        "task_name": "MyTask1",
        "total_target": "1",
        "task_id": "633",
        "os_platform_name": "Windows",
        "collection_id": "312",
        "collection_status": "2",
        "user_id": "1",
        "task_modified_time": "1756191374069",
        "scheduler_class_id": "--",
        "template_id": "--",
        "task_type": "18",
        "task_creation_time": "1756191374069",
        "first_name": "admin",
        "os_platform_id": "1",
        "remarks": "312"
      }
    ],
    "limit": 25,
    "page": 1
  },
  "message_version": "1.3",
  "status": "success"
}
```

![ ](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.