PATCH

/dynamic-thing-groups/{thingGroupName}

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

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

Access Token Required: API Key

Path Parameters

thingGroupNamestringrequired

The name of the dynamic thing group to update.

Body Params

indexNamestring

The dynamic thing group index to update. <note> Currently one index is supported: <code>AWS_Things</code>. </note>

queryStringstring

The dynamic thing group search query string to update.

queryVersionstring

The dynamic thing group query version to update. <note> Currently one query version is supported: "2017-09-30". If not specified, the query version defaults to this value. </note>

expectedVersioninteger

The expected version of the dynamic thing group to update.

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/dynamic-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}