---
title: "POST /managed-things-command/{ManagedThingId}"
method: POST
path: "/managed-things-command/{ManagedThingId}"
---

# POST /managed-things-command/{ManagedThingId}

`POST /managed-things-command/{ManagedThingId}`

Send the command to the device represented by the managed thing.

## Path parameters

- `ManagedThingId` string, required

## Request body

- object
  - `Endpoints` CommandEndpoint[], required — The device endpoint.
    - `endpointId` string, required — The id of the endpoint for a managed thing.
    - `capabilities` CommandCapability[], required — Describe the endpoint with an id, a name, and the relevant capabilities for sending commands.
      - `id` string, required — Describe the capability with an id.
      - `name` string, required — Describe the capability with an name.
      - `version` string, required — Describe the capability with a version.
      - `actions` CapabilityAction[], required — Describe the command capability with the actions it supports.
        - `name` string, required — Describe a capability action with a name.
        - `ref` string — Describe a capability action with an reference.
        - `actionTraceId` string — Describe a capability action with an <code>actionTraceId</code> for a response command.
        - `parameters` object — Describe a capability action with a capability property.
  - `ConnectorAssociationId` string — ConnectorAssociationId is deprecated
  - `AccountAssociationId` string — The identifier of the account association to use when sending a command to a managed thing.

## Response `202`

Success

- SendManagedThingCommandResponse
  - `TraceId` string — The trace request identifier. This is generated by IoT managed integrations and can be used to trace this command and its related operations in CloudWatch.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — InternalServerException
- `483` — UnauthorizedException
- `484` — ServiceUnavailableException
- `485` — ResourceNotFoundException
- `486` — ThrottlingException

---

[API](https://skmtc.net/aws/apis/iot-managed-integrations.md) · [All operations](https://skmtc.net/aws/apis/iot-managed-integrations/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iot-managed-integrations/versions/d043c13c812a/schema)