---
title: "PATCH /dimensions/{name}"
method: PATCH
path: "/dimensions/{name}"
---

# PATCH /dimensions/{name}

`PATCH /dimensions/{name}`

Updates the definition for a dimension. You cannot change the type of a dimension after it is created (you can delete it and recreate it).

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

## Path parameters

- `name` string, required

## Request body

- object
  - `stringValues` DimensionStringValue[], required — Specifies the value or list of values for the dimension. For <code>TOPIC_FILTER</code> dimensions, this is a pattern used to match the MQTT topic (for example, "admin/#").

## Response `200`

Success

- UpdateDimensionResponse
  - `name` string — A unique identifier for the dimension.
  - `arn` string — The Amazon Resource Name (ARN)of the created dimension.
  - `type` 'TOPIC_FILTER' — The type of the dimension.
  - `stringValues` DimensionStringValue[] — The value or list of values used to scope the dimension. For example, for topic filters, this is the pattern used to match the MQTT topic name.
  - `creationDate` string, date-time — The date and time, in milliseconds since epoch, when the dimension was initially created.
  - `lastModifiedDate` string, date-time — The date and time, in milliseconds since epoch, when the dimension was most recently updated.

## Other responses

- `480` — InternalFailureException
- `481` — InvalidRequestException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException

---

[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)