# Restart multiple devices or groups simultaneously

initiates bulk restart

## Endpoint

**POST** `/api/v1/mdm/actions/restart`

## Request

### Request URL

`https://{server-hostname}:8383/api/v1/mdm/actions/restart`

### Scope

`MDMInventory.CREATE`

### Header

`Authorization: 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 restart. Fetch from [Get Device List](https://www.manageengine.com/products/desktop-central/help/api/onpremise/devices-get-device-list.html)
- `actions` `array` — Optional
  - Command name. Must be 'restart'
- `groups` `array` — Optional
  - Array of group IDs whose devices should be restarted
- `reason_message` `string` — Optional
  - Reason message for the bulk action

### Sample Request

```curl
curl --request POST \
  --url https://appdomain/api/v1/mdm/actions/restart \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"devices":["9508000000013121","9508000000013691"],"reason_message":["Routine maintenance"],"groups":["9007199254741597","9007199254741595"],"actions":["restart"]}'
```

### Sample Request Body

Restart multiple devices

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

## Response

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

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