---
title: "POST /api/metric/{id}/dimension/{dimension-key}"
method: POST
path: "/api/metric/{id}/dimension/{dimension-key}"
tags: ["/api/metric"]
---

# POST /api/metric/{id}/dimension/{dimension-key}

`POST /api/metric/{id}/dimension/{dimension-key}`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/metric/{id}/dimension/{dimension-key}`
- Auth: API key in header `X-API-Key`

Update a metric dimension's `display_name`, `description`, `default_temporal_unit`, and/or source
  column.

  `source` is a `{type, field-id}`; the new column must have the same effective type.

## Path parameters

- `id` integer, required
- `dimension-key` string, required

## Request body

- object
  - `default_temporal_unit` string: value must be a non-blank string.
  - `description` string, nullable
  - `display_name` string: value must be a non-blank string.
  - `source` object, nullable
    - `field-id` integer, required: value must be an integer greater than zero.

## Response `2XX`

Successful response

- object

## Other responses

- `4XX`: Client error response
- `5XX`: Server error response

## Changes

- **2026-11-04** `2e178f5a7934`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/metabase/apis/metabase-api/changes/api/metric/:id/dimension/:dimension-key/post.md)

---

[API](https://skmtc.dev/metabase/apis/metabase-api.md) - [All operations](https://skmtc.dev/metabase/apis/metabase-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metabase/apis/metabase-api/revisions/2e178f5a7934?raw)