Skip to Content
API ReferenceModelPOST /refresh

POST /model/refresh

Model Refresh

Refresh model materialized views and invalidate caches.

Request Body (RefreshModelApiRequest)

FieldTypeRequiredDescription
targetsstring[]NoMV targets to refresh (omit for all). Options: model_drafts_mv
idempotency_keystringNoOperation key for ack
acceptbooleanNoAccept or reject. Only meaningful with idempotency_key
softbooleanNoStage the refresh as a pending (held) request — recorded but not enqueued; ack with accept releases/enqueues it

Response (RefreshResponse)

FieldTypeRequiredDescription
successbooleanYes
refreshed_viewsstring[]Yes
invalidated_tagsstring[]Yes
idempotency_keystringNoIdempotency key echoed back for client correlation
Last updated on