---
title: "Update Cube Values"
method: POST
path: "/cube/update"
tags: ["Cube Data"]
---

# Update Cube Values

`POST /cube/update`

This endpoint can be used to update data in the OLAP cube. The message will be used in the changelog for any changes to data. The raw data of the matrix as well as the filters should be passed. The data for `matrix.data` should be a 2D array of data similar to a spreadsheet. At least one row and one column of dimension names should be provided. The data in `matrix.filters` would contain values for any top level dimension that isn't a part of the passed 2D data matrix.

## Query parameters

- `background` boolean

## Request body

- CubeUpdateRequest
  - `message` string, required
  - `matrix` object, required

## Response `200`

`DATA_UPDATED` - Data was successfully updated as part of this request

`NO_DATA_UPDATED` - The request was successful, but no data was modified by it

`DATA_UPDATE_BACKGROUNDED` - Due to the amount of data sent, it will be processed in the background

- CubeUpdateResponse
  - `code` string, required
  - `message` string, required
  - `change` CubeUpdateResponseChange, required
    - `id` integer, required
    - `url` string, uri, required
    - `num_changes` integer, required
  - `nonwriteable_dimensions` CubeUpdateResponseNonwriteableDimensions, required
    - `num_parents` integer, required
    - `num_formulas` integer, required
    - `num_write_protected` integer, required

---

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