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

# Delete a custom cube TLD

`DELETE /dimensions/tld/{id}`

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

## Path parameters

- `id` string, required

## Headers

- `X-Company-ID` string, required

## Response `202`

TLD deletion accepted and queued; response `data` is a snapshot of the TLD before deletion. An email is sent when deletion completes (or fails).

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

## Other responses

- `400` — Invalid request — e.g. default TLD, multi-currency entity TLD, non-TLD, source-dimension TLD, or active ERP dimension mappings still reference this TLD subtree.
- `403` — Permission denied — user cannot manage dimensions
- `404` — Dimension not found or not a cube TLD (e.g. source-data-table root)
- `409` — Preflight failed — cube has active work (publish lock, import blocks, or maintenance lock).

---

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