---
title: "PUT /assets/{assetId}"
method: PUT
path: "/assets/{assetId}"
---

# PUT /assets/{assetId}

`PUT /assets/{assetId}`

Updates an asset's name. For more information, see <a href="https://docs.aws.amazon.com/iot-sitewise/latest/userguide/update-assets-and-models.html">Updating assets and models</a> in the <i>IoT SiteWise User Guide</i>.

## Path parameters

- `assetId` string, required

## Request body

- object
  - `assetName` string, required — A friendly name for the asset.
  - `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.
  - `assetDescription` string — A description for the asset.

## Response `202`

Success

- UpdateAssetResponse
  - `assetStatus` object, required — The status of the asset, which contains a state (<code>UPDATING</code> after successfully calling this operation) and any error message.
    - `state` 'CREATING' | 'ACTIVE' | 'UPDATING' | 'DELETING' | 'FAILED', required — The current status of the asset.
    - `error` object — Contains associated error information, if any.
      - `code` 'VALIDATION_ERROR' | 'INTERNAL_FAILURE', required — The error code.
      - `message` string, required — The error message.
      - `details` DetailedError[] — A list of detailed errors.
        - `code` 'INCOMPATIBLE_COMPUTE_LOCATION' | 'INCOMPATIBLE_FORWARDING_CONFIGURATION', required — The error code.
        - `message` string, required — The error message.

## Other responses

- `480` — InvalidRequestException
- `481` — ResourceAlreadyExistsException
- `482` — ResourceNotFoundException
- `483` — InternalFailureException
- `484` — ThrottlingException
- `485` — 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)