Create a materialization schedule for a workbook element (Beta)
Create a materialization schedule for a workbook element (Beta)
This endpoint creates a materialization schedule for an element in a workbook. The scheduled run materializes the element's data on the given cadence, 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).
**Beta**: This documentation describes a public beta feature and is subject to the [Beta features](/docs/sigma-product-releases#beta-features) disclaimer.
### Usage notes
- Retrieve the **workbookId** by calling the [/v2/workbooks](https://help.sigmacomputing.com/reference/list-workbooks) endpoint.
- Retrieve the **elementId** by calling the [/v2/workbooks/{workbookId}/elements](https://help.sigmacomputing.com/reference/list-workbook-elements) endpoint.
- [Write access](https://help.sigmacomputing.com/docs/set-up-write-access) must be enabled on your connection.
- To perform this operation, you must use API credentials owned by a user assigned to an account type with the **Schedule materializations** permission.
- An element can have at most one materialization schedule.
- The materialization run starts immediately upon creation using the latest published version of the workbook.
Authentication
AuthorizationBearer
OAuth authentication of the form <token>.
Path parameters
workbookId
elementId
Request
The request body.
schedule
When to run the materialization.
Response
The response body.
sheetId
Identifier of the materialization schedule for the element
elementId
Identifier of the element being materialized
elementName
schedule
configuredAt
paused

