---
title: "POST /task/{taskId}/execution/{managedDeviceId}"
method: POST
path: "/task/{taskId}/execution/{managedDeviceId}"
---

# POST /task/{taskId}/execution/{managedDeviceId}

`POST /task/{taskId}/execution/{managedDeviceId}`

Checks the status of a remote task running on one or more target devices.

## Path parameters

- `managedDeviceId` string, required
- `taskId` string, required

## Response `200`

Success

- DescribeExecutionOutput
  - `executionId` string — The ID of the execution.
  - `lastUpdatedAt` string, date-time — When the status of the execution was last updated.
  - `managedDeviceId` string — The ID of the managed device that the task is being executed on.
  - `startedAt` string, date-time — When the execution began.
  - `state` 'QUEUED' | 'IN_PROGRESS' | 'CANCELED' | 'FAILED' | 'SUCCEEDED' | 'REJECTED' | 'TIMED_OUT' — The current state of the execution.
  - `taskId` string — The ID of the task being executed on the device.

## Other responses

- `480` — ThrottlingException
- `481` — InternalServerException
- `482` — ResourceNotFoundException
- `483` — ValidationException
- `484` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/snow-device-management.md) · [All operations](https://skmtc.net/aws/apis/snow-device-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/snow-device-management/versions/d575ed9d99bf/schema)