---
title: "Partially update a cube value range"
method: PATCH
path: "/ranges/{id}"
tags: ["Cube Value Range"]
---

# Partially update a cube value range

`PATCH /ranges/{id}`

Update one or more editable fields on an existing cube value range.

## Path parameters

- `id` string, required

## Query parameters

- `collapse_coordinates` array[]
  - integer[]
- `header_discovery` 'false' | 'true'

## Headers

- `X-Company-ID` string, required

## Request body

- PatchedA1CubeValueRange — Mixin to delegate create, update, and destroy operations to a service class.
  - `id` integer
  - `headers` object
  - `data` unknown
  - `filters` unknown
  - `range_type` 'PIVOT' | 'DRILLDOWN' — * `PIVOT` - Pivot * `DRILLDOWN` - Drilldown
  - `name` string, nullable
  - `fetch_enabled` boolean
  - `publish_enabled` boolean
  - `row_discovery_enabled` boolean
  - `currency` CurrencyNested
    - `id` integer, required
    - `name` string, required
    - `code` string, required
  - `exclude_zeros` boolean
  - `suppressed_row_dimensions` unknown
  - `created_by_id` integer, nullable
  - `collapse_coordinates` array[]
    - integer[]
  - `expand_all_coordinates` array[]
    - integer[]
  - `expand_coordinates` array[]
    - integer[]
  - `tags` unknown
  - `discovered_row_headers` object
  - `delete` string[]
  - `insert` object

## Response `200`

- A1CubeValueRange — Mixin to delegate create, update, and destroy operations to a service class.
  - `id` integer, required
  - `headers` object, required
  - `data` unknown
  - `filters` unknown, required
  - `range_type` 'PIVOT' | 'DRILLDOWN' — * `PIVOT` - Pivot * `DRILLDOWN` - Drilldown
  - `name` string, nullable
  - `fetch_enabled` boolean
  - `publish_enabled` boolean
  - `row_discovery_enabled` boolean
  - `currency` CurrencyNested
    - `id` integer, required
    - `name` string, required
    - `code` string, required
  - `exclude_zeros` boolean
  - `suppressed_row_dimensions` unknown
  - `created_by_id` integer, nullable, required
  - `collapse_coordinates` array[]
    - integer[]
  - `expand_all_coordinates` array[]
    - integer[]
  - `expand_coordinates` array[]
    - integer[]
  - `tags` unknown
  - `discovered_row_headers` object, required
  - `delete` string[], required
  - `insert` object, required

## Other responses

- `400`

---

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