Materialization API

The materialization API allows you to synchronize a view’s data with the latest data. This API enables you to refresh a materialized view to synchronize its data with the latest data load to the underlying tables.

You may want to invoke this API in the following scenarios:

  • When the status of a materialized view is Stale (out of sync) due to an incremental data load

  • When the status of a materialized view is Error due to an error that occurred

If your materialized view refreshes on a schedule, you cannot use the materialization API to refresh it again during the same refresh window.

Resource URL

POST /tspublic/v1/materialization/refreshview/{id}

Request Parameters

Path Parameter Description

id

String. The GUID of the metadata object.

Request Example

cURL
curl -X POST \
--header 'Content-Type: */*' \
--header 'Accept: application/json' \
--header 'X-Requested-By: ThoughtSpot' \ 'https://<ThoughtSpot-host>/callosum/v1/tspublic/v1/materialization/refreshview/e27f3c1c-a9cd-4996-9029-097449cd6f60'
Request URL
https://<ThoughtSpot-host>/callosum/v1/tspublic/v1/materialization/refreshview/e27f3c1c-a9cd-4996-9029-097449cd6f60

Response Example

Not applicable
204 - Refresh submitted

Response codes

HTTP status code Description

204

Successful operation

400

Invalid parameter values

500

The specified view is not materialized or the materialized view is not stale


Was this page helpful?