PATCH

/thing-groups/{thingGroupName}

http://iot.{region}.amazonaws.com/thing-groups/{thingGroupName}

<p>Update a thing group.</p> <p>Requires permission to access the <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions">UpdateThingGroup</a> action.</p>

Access Token Required: API Key

Path Parameters

thingGroupNamestringrequired

The thing group to update.

Body Params

expectedVersioninteger

The expected version of the thing group. If this does not match the version of the thing group being updated, the update will fail.

thingGroupPropertiesobjectrequired

Thing group properties.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request PATCH \
2     --url 'http://iot.{region}.amazonaws.com/thing-groups/{thingGroupName}' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}