---
title: "Update dimension"
method: PUT
path: "/instances/{instance_id}/dimensions/{dimension}"
tags: ["Private"]
---

# Update dimension

`PUT /instances/{instance_id}/dimensions/{dimension}`

Update the label and/or description of a dimension within an instance, by providing dimension name and properties to over write

## Path parameters

- `instance_id` string, required
- `dimension` string, required

## Headers

- `If-Match` string

## Request body

- UpdateInstanceDimension — Possible fields to be updated against a dimension for an instance resource
  - `description` string — The dimension description
  - `label` string — A human readable label for dimension

## Response `200`

The instance has been updated

## Other responses

- `400` — Failed to process the request due to invalid request
- `401` — The token provided is unauthorised to carry out this operation
- `403` — The request is forbidden
- `404` — The instance was not found
- `409` — Failed to process the request due to a conflict
- `500` — Failed to process the request due to an internal error

---

[API](https://skmtc.net/office-of-national-statistics/apis/dataset-api.md) · [All operations](https://skmtc.net/office-of-national-statistics/apis/dataset-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/office-of-national-statistics/dataset-api/revisions/a2947a13d675/schema)