Update a materialization schedule for a data model element (Beta)

View as Markdown
This endpoint updates the schedule of an existing materialization schedule for an element in a data model. Only the cron cadence and timezone are changed; the element must already have a materialization schedule. 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 **dataModelId** by calling the [/v2/dataModels](https://help.sigmacomputing.com/reference/list-data-models) endpoint. - Retrieve the **elementId** by calling the [/v2/dataModels/{dataModelId}/elements](https://help.sigmacomputing.com/reference/list-data-model-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. - The element must already have a materialization schedule. To create one, use the [create data model materialization schedule](https://help.sigmacomputing.com/reference/create-data-model-materialization-schedule) endpoint.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Path parameters

dataModelIdstringRequired
elementIdstringRequired

Request

The request body.
scheduleobjectRequired
When to run the materialization.

Response

The response body.
sheetIdstring
Identifier of the materialization schedule for the element
elementIdstring
Identifier of the element being materialized
elementNamestring
scheduleobject or null
configuredAtdatetime
pausedboolean