---
title: "Run materialization for a data model element"
method: POST
path: "/v2/dataModels/{dataModelId}:materialize"
tags: ["Data models"]
---

# Run materialization for a data model element

`POST /v2/dataModels/{dataModelId}:materialize`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/dataModels/{dataModelId}:materialize`
- Auth: HTTP bearer

This endpoint runs a scheduled materialization for an element in a data model. 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/dataModels/{dataModelId}/materializationSchedules](https://help.sigmacomputing.com/reference/list-data-model-materialization-schedules) endpoint.
  - Retrieve the **dataModelId** by calling the [/v2/dataModels](https://help.sigmacomputing.com/reference/list-data-models) endpoint.

  ### Usage scenarios
  - **Performance optimization:** Use this endpoint to improve response times for frequently accessed data model elements.
  - **Data refresh:** Allows users to manually (programmatically) refresh the data of specific data model 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

- `dataModelId` string, required

## Request body

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

## Response `200`

The response body.

- DataModelsMaterializeDataModelElementResponse200
  - `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)