---
title: "Rename a custom cube TLD"
method: PUT
path: "/dimensions/tld/{id}"
tags: ["Dimensions"]
---

# Rename a custom cube TLD

`PUT /dimensions/tld/{id}`

API for managing custom cube top-level dimensions (TLDs).

## Path parameters

- `id` string, required

## Headers

- `X-Company-ID` string, required

## Request body

- TopLevelDimension
  - `id` integer, required
  - `name` string, required
  - `active` boolean, required

## Response `200`

TLD renamed; response contains the updated dimension.

- TopLevelDimension
  - `id` integer, required
  - `name` string, required
  - `active` boolean, required

## Other responses

- `400` — Invalid request — e.g. default TLD rename, validation error
- `403` — Permission denied — user cannot manage this dimension
- `404` — Dimension not found or not a cube TLD

---

[API](https://skmtc.net/cubesoftware/apis/cube-api.md) · [All operations](https://skmtc.net/cubesoftware/apis/cube-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cubesoftware/cube-api/revisions/67d9f45bb99b/schema)