Skip to main content
POST
Start async table materialization or refresh

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

table_id
string
required

Calculation table identifier.

Required string length: 1 - 128
Pattern: ^[a-zA-Z0-9_-]+$

Query Parameters

confirm
boolean
default:false

Set confirm=true to start materialization or refresh, which writes the table's stored data.

Body

application/json
operation
enum<string>
required

materialize builds a calculation table for the first time; refresh rebuilds an already materialized table.

Available options:
materialize,
refresh
idempotencyKey
string
required

Reuse this key when retrying the same request, including after a timeout. Use a new key for a new run.

Required string length: 1 - 128
Pattern: ^[a-zA-Z0-9_.:-]+$

Response

Successful Response

data
GridMaterializationStarted · object
required