---
title: "Sends an action to devices."
method: POST
path: "/api/v1/accounts/{accountId}/devices/action"
---

# Sends an action to devices.

`POST /api/v1/accounts/{accountId}/devices/action`

## Request

- Base URL: `https://api.usa.cloud.watchguard.com/rest/aether-endpoint-security/aether-mgmt`
- URL: `https://api.usa.cloud.watchguard.com/rest/aether-endpoint-security/aether-mgmt/api/v1/accounts/{accountId}/devices/action`
- Auth: API key in header `WatchGuard-API-Key` and HTTP bearer
- TypeScript: <https://skmtc.dev/watchguard/apis/aether-endpoint-security-api/docs/api/v1/accounts/:accountId/devices/action/post.ts> (a function with typed inputs; its response is checked against the schema)

Initiates an action on the specified devices. For example, send an action to reboot a device.

## Path parameters

- `accountId` string, required

## Request body

- DevicesActionInput
  - `device_ids` string[]
  - `action_type` 1: Device action type. - 1: Reboot
  - `count_down_type` 1 | 2 | 3 | 4 | 5 | 6 | 7: Amount of time to count down to a reboot action. - 1: Immediate - 2: Fifteen minutes - 3: Thirty minutes - 4: One hour - 5: Two hours - 6: Four hours - 7: Eight hours

## Response `200`

OK. Returns the IDs of devices processed in this operation.

- DevicesActionOutput
  - `processed_device_ids` string[]
  - `no_executed_by_not_found_device_ids` string[]

## Other responses

- `400`: BAD REQUEST.
- `403`: ACCESS DENIED.
- `404`: NOT FOUND.
- `405`: METHOD NOT ALLOWED.
- `500`: INTERNAL ERROR.

---

[API](https://skmtc.dev/watchguard/apis/aether-endpoint-security-api.md) - [All operations](https://skmtc.dev/watchguard/apis/aether-endpoint-security-api/llms.txt) - [OpenAPI document](https://skmtc.dev/watchguard/apis/aether-endpoint-security-api/revisions/1376eee70d39?raw)