Sign in

v1

latestOpenAPI 3.1.02026-07-1730321418.0 KB
Datasets

Refresh Dataset

Trigger an on-demand refresh for an accelerated dataset.

The refresh only applies to full and append refresh modes (not changes mode). Datasets without acceleration return 400 — the previous load: on_demand flow has been removed; deferred datasets (declared schema + ready_state: on_registration) are materialised automatically on first query and do not need a manual trigger.

post/v1/datasets/{name}/acceleration/refresh

Path parameters

namestring required

The name of the dataset to refresh.

Request body

refresh_jitter_maxstring nullable

The maximum amount of jitter to add to the refresh. Defaults to the refresh_jitter_max specified in the spicepod, or 10% of the refresh_check_interval.

refresh_mode'disabled' | 'full' | 'append' | 'changes' | 'caching' | 'snapshot'
refresh_sqlstring nullable

The SQL statement used for this refresh. Defaults to the refresh_sql specified in the spicepod, if any.

Example request

{
  "refresh_jitter_max": "10s"
}

Response

Dataset refresh triggered successfully

messagestring required

The message describing the result of the request