---
title: "PATCH /things/{thingName}"
method: PATCH
path: "/things/{thingName}"
---

# PATCH /things/{thingName}

`PATCH /things/{thingName}`

Updates the data for a thing.

Requires permission to access the [UpdateThing](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

## Path parameters

- `thingName` string, required

## Request body

- object
  - `thingTypeName` string — The name of the thing type.
  - `attributePayload` object — The attribute payload.
    - `attributes` object — <p>A JSON string containing up to three key-value pair in JSON format. For example:</p> <p> <code>{\"attributes\":{\"string1\":\"string2\"}}</code> </p>
    - `merge` boolean — <p>Specifies whether the list of attributes provided in the <code>AttributePayload</code> is merged with the attributes stored in the registry, instead of overwriting them.</p> <p>To remove an attribute, call <code>UpdateThing</code> with an empty attribute value.</p> <note> <p>The <code>merge</code> attribute is only valid when calling <code>UpdateThing</code> or <code>UpdateThingGroup</code>.</p> </note>
  - `expectedVersion` integer — The expected version of the thing record in the registry. If the version of the record in the registry does not match the expected version specified in the request, the <code>UpdateThing</code> request is rejected with a <code>VersionConflictException</code>.
  - `removeThingType` boolean — Remove a thing type association. If <b>true</b>, the association is removed.

## Response `200`

Success

- UpdateThingResponse — The output from the UpdateThing operation.

## Other responses

- `480` — InvalidRequestException
- `481` — VersionConflictException
- `482` — ThrottlingException
- `483` — UnauthorizedException
- `484` — ServiceUnavailableException
- `485` — InternalFailureException
- `486` — ResourceNotFoundException

---

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