---
title: "POST /#X-Amz-Target=IoTAutobahnControlPlane.UpdateStateTemplate"
method: POST
path: "/#X-Amz-Target=IoTAutobahnControlPlane.UpdateStateTemplate"
---

# POST /#X-Amz-Target=IoTAutobahnControlPlane.UpdateStateTemplate

`POST /#X-Amz-Target=IoTAutobahnControlPlane.UpdateStateTemplate`

Updates a state template.

Access to certain Amazon Web Services IoT FleetWise features is currently gated. For more information, see [Amazon Web Services Region and feature availability](https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/fleetwise-regions.html) in the _Amazon Web Services IoT FleetWise Developer Guide_.

## Headers

- `X-Amz-Target` 'IoTAutobahnControlPlane.UpdateStateTemplate', required

## Request body

- UpdateStateTemplateRequest
  - `identifier` string, required — The unique ID of the state template.
  - `description` string — A brief description of the state template.
  - `stateTemplatePropertiesToAdd` NodePath[] — Add signals from which data is collected as part of the state template.
  - `stateTemplatePropertiesToRemove` NodePath[] — Remove signals from which data is collected as part of the state template.
  - `dataExtraDimensions` NodePath[] — <p>A list of vehicle attributes to associate with the payload published on the state template's MQTT topic. (See <a href="https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/process-visualize-data.html#process-last-known-state-vehicle-data"> Processing last known state vehicle data using MQTT messaging</a>). For example, if you add <code>Vehicle.Attributes.Make</code> and <code>Vehicle.Attributes.Model</code> attributes, Amazon Web Services IoT FleetWise will enrich the protobuf encoded payload with those attributes in the <code>extraDimensions</code> field.</p> <p>Default: An empty array</p>
  - `metadataExtraDimensions` NodePath[] — A list of vehicle attributes to associate with user properties of the messages published on the state template's MQTT topic. (See <a href="https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/process-visualize-data.html#process-last-known-state-vehicle-data"> Processing last known state vehicle data using MQTT messaging</a>). For example, if you add <code>Vehicle.Attributes.Make</code> and <code>Vehicle.Attributes.Model</code> attributes, Amazon Web Services IoT FleetWise will include these attributes as User Properties with the MQTT message.

## Response `200`

Success

- UpdateStateTemplateResponse
  - `name` string — The name of the state template.
  - `arn` string — The Amazon Resource Name (ARN) of the state template.
  - `id` string — The unique ID of the state template.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — LimitExceededException
- `483` — ThrottlingException
- `484` — ValidationException
- `485` — InvalidSignalsException
- `486` — AccessDeniedException

---

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