# Retrieves the configuration and status details of the specified power operation task

Returns the configuration and status details of the specified scheduled power operation task, including task name, operation type, target computers, schedule, and current execution status.

## Endpoints

`GET /dcapi/tools/shutdown/tasks/{taskId}`

## Request URL

https://[*{serverurl}*](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/dcapi/tools/shutdown/tasks/{taskId}

## Scope

`DesktopCentralCloud.Tools.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** `string` — **Mandatory**
  - `application/json`

### Path Parameters

- **taskId** `string` — **Mandatory**
  - The unique identifier of the task

## Sample Request

```curl
curl --request GET \
  --url https://appdomains/dcapi/tools/shutdown/tasks/{taskId} \
  --header 'Accept: application/json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

#### Response Body — `application/json`

`JSON Object`

- **taskId** `long`
  - Scheduled shutdown task unique identifier
- **taskName** `string`
  - User-defined task name
- **operation** `integer`
  - Operation type: 1=Shutdown, 2=Restart, 3=Logoff, 4=Lock, 5=Hibernate
- **operationStr** `string`
  - Human-readable operation name
- **status** `string`
  - Task status: Active, Suspended, Completed
- **platform** `integer`
  - Target platform: 1=Windows, 2=macOS
- **shutdownMessage** `string`
  - Message displayed to end users before the operation
- **shutdownTimeout** `integer`
  - Timeout in seconds before the operation executes
- **postPoneEnabled** `boolean`
  - Whether end users can postpone the operation
- **skipEnabled** `boolean`
  - Whether end users can skip the operation
- **nextRunTime** `long`
  - Next scheduled execution time (epoch)
- **targetCount** `integer`
  - Number of target computers

## Possible Response Codes

- **200** — HTTP code

## Sample Response: HTTP 200

```json
{
  "postPoneEnabled": true,
  "operationStr": "Shutdown",
  "nextRunTime": 1711508400000,
  "shutdownTimeout": 300,
  "skipEnabled": false,
  "taskName": "Nightly Shutdown",
  "shutdownMessage": "System will shutdown in 5 minutes.",
  "operation": 1,
  "targetCount": 20,
  "taskId": 5,
  "platform": 1,
  "status": "Active"
}
```

## API Rate Limits

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