---
title: "Run materialization for a workbook element"
method: POST
path: "/v2/workbooks/{workbookId}/materializations"
tags: ["Workbooks"]
---

# Run materialization for a workbook element

`POST /v2/workbooks/{workbookId}/materializations`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/workbooks/{workbookId}/materializations`
- Auth: HTTP bearer

This endpoint runs a scheduled materialization for an element in a workbook. Materialization processes the data of the specified element, allowing the data to be stored or cached for optimized access and performance.

  For more details on materialization, see [Materialization](https://help.sigmacomputing.com/docs/materialization).

  ### Usage notes
  - The materialization schedule for the specified element must be created beforehand.
  - Retrieve the **sheetId** by calling the [/v2/workbooks/{workbookId}/materialization-schedules](https://help.sigmacomputing.com/reference/list-materialization-schedules) endpoint.
  - Retrieve the **workbookId** by calling the [/v2/workbooks](https://help.sigmacomputing.com/reference/list-workbooks) endpoint.

  ### Usage scenarios
  - **Performance optimization:** Use this endpoint to improve response times for frequently accessed workbook elements.
  - **Data refresh:** Allows users to manually (programmatically) refresh the data of specific workbook elements to ensure that the latest data is available for analysis and reporting.

  ### Best practices
  - Prioritize materialization for elements that are heavily used or form critical components of business reports.
  - Monitor the performance impacts of materialization and adjust strategies as necessary to optimize resource usage and response times.

## Path parameters

- `workbookId` string, required

## Request body

- object
  - `sheetId` string, required: Identifier for the materialization schedule of this element.

## Response `200`

The response body.

- WorkbooksMaterializeWorkbookElementResponse200
  - `materializationId` string, required

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)