---
title: "Bulk Update Dimensions"
method: POST
path: "/dimensions/bulk"
tags: ["Dimensions"]
---

# Bulk Update Dimensions

`POST /dimensions/bulk`

This endpoint bulk updates dimensions.

## Request body

- BulkDimensionUpdateRequest
  - `batch_id` string, required — The batch ID for the bulk update operation
  - `tld_id` integer, required — The top-level dimension ID to update dimensions under

## Response `200`

Bulk update request accepted and queued for processing

- Dimension
  - `id` integer, required
  - `parent_id` integer, nullable, required
  - `name` string, required
  - `active` boolean, required
  - `status` 'ENABLED' | 'DISABLING_VALUES' | 'CLEARING_VALUES' | 'VALUES_CLEARED' | 'DISABLED' — * `ENABLED` - Enabled * `DISABLING_VALUES` - Disabling Values * `CLEARING_VALUES` - Clearing Values * `VALUES_CLEARED` - Values Cleared * `DISABLED` - Disabled
  - `type` 'BASIC' | 'FORMULA' | 'TAG' — * `BASIC` - Basic * `FORMULA` - Formula * `TAG` - Tag
  - `rollup_type` union
    - 'SUM' | 'AVERAGE' | 'BALANCE' | 'BEGINNING_BALANCE' — * `SUM` - Sum * `AVERAGE` - Average * `BALANCE` - Ending Balance * `BEGINNING_BALANCE` - Beginning Balance
    - ''
    - unknown
  - `formula` string, required
  - `write_protection` 'NONE' | 'BLOCK' | 'ACTUALS' | 'AI' — * `NONE` - None * `BLOCK` - Block * `ACTUALS` - Actuals * `AI` - AI
  - `position` integer
  - `special_case_id` string, nullable
  - `date` string, date, nullable
  - `has_children` boolean
  - `write_block_reason` string, required — If the dimension cannot be written to, return the reason why. Otherwise, return nothing. Args: obj: The model object to be checked if can be written to. Returns: str (Optional): The error blocking the dimension from being written to, if one exists
  - `metadata` string, nullable

## Other responses

- `400` — Invalid request - validation error
- `403` — Permission denied - user not allowed to modify dimensions under this TLD
- `404` — Top-level dimension not found

---

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