# Shut down multiple devices or groups simultaneously

initiates bulk shutdown

## Endpoint

`POST /api/v1/mdm/actions/shutdown`

## Request URL

`https://{serverurl}/api/v1/mdm/actions/shutdown`

## Scope

`MDMOnDemand.MDMInventory.CREATE`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Content-Type** (`string`, Mandatory): `application/json`
- **Accept** (`string`, Mandatory): `application/json`

### Request Body

`application/json`

- `devices` (`array`, Mandatory): Array of device IDs to shut down. Fetch from [Get Device List](https://www.manageengine.com/mobile-device-management/help/api/cloud/devices-get-device-list.html)
- `actions` (`array`, Optional): Action name. Must be 'shutdown'
- `groups` (`array`, Optional): Array of group IDs whose devices should be shut down
- `reason_message` (`string`, Optional): Reason message for the bulk action

### Sample Request

```bash
curl --request POST \
  --url https://appdomain/api/v1/mdm/actions/shutdown \
  --header 'Accept: application/json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"devices":["9508000000013121","9508000000013691"]}'
```

### Sample Request Body

Shutdown multiple devices

```json
{
  "devices": [
    "9508000000013121",
    "9508000000013691"
  ],
  "reason_message": [
    "Routine maintenance"
  ],
  "groups": [
    "9007199254741597",
    "9007199254741595"
  ],
  "actions": [
    "shutdown"
  ]
}
```

## Response Parameters

### HTTP Code 200

Response Body: `application/json`

- `success_list` (`JSON array`): List of devices where the command was sent successfully
- `total_count` (`integer`): Total count of devices selected for the bulk action
- `not_applicable_count` (`integer`): Count of devices where the command is not applicable
- `success_count` (`integer`): Count of devices where the command was successfully initiated
- `na_list` (`JSON array`): List of devices where the command is not applicable

### Possible Response Codes

- **200** (`HTTP code`)

### Sample Response: HTTP 200

Bulk action result with success and not-applicable lists

```json
{
  "success_list": [
    {
      "device_id": "9508000000013121",
      "remarks": "--",
      "status": "SCHEDULED"
    }
  ],
  "total_count": 3,
  "not_applicable_count": 1,
  "success_count": 1,
  "na_list": [
    {
      "device_id": "9508000000013691",
      "remarks": "Device is unmanaged",
      "status": "NOT_APPLICABLE"
    }
  ]
}
```

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