---
title: "POST /assets/{assetId}/associate"
method: POST
path: "/assets/{assetId}/associate"
---

# POST /assets/{assetId}/associate

`POST /assets/{assetId}/associate`

Associates a child asset with the given parent asset through a hierarchy defined in the parent asset's model. For more information, see <a href="https://docs.aws.amazon.com/iot-sitewise/latest/userguide/add-associated-assets.html">Associating assets</a> in the <i>IoT SiteWise User Guide</i>.

## Path parameters

- `assetId` string, required

## Request body

- object
  - `hierarchyId` string, required — The ID of a hierarchy in the parent asset's model. Hierarchies allow different groupings of assets to be formed that all come from the same asset model. For more information, see <a href="https://docs.aws.amazon.com/iot-sitewise/latest/userguide/asset-hierarchies.html">Asset hierarchies</a> in the <i>IoT SiteWise User Guide</i>.
  - `childAssetId` string, required — The ID of the child asset to be associated.
  - `clientToken` string — A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

## Response `200`

Success

## Other responses

- `480` — InvalidRequestException
- `481` — ResourceAlreadyExistsException
- `482` — ResourceNotFoundException
- `483` — InternalFailureException
- `484` — LimitExceededException
- `485` — ThrottlingException
- `486` — ConflictingOperationException

---

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