Skip to Content
API ReferenceAgentPOST /refresh

POST /agent/refresh

Agent Refresh

Refresh agent materialized views and invalidate caches.

Request Body (RefreshAgentApiRequest)

FieldTypeRequiredDescription
targetsstring[]NoMV targets to refresh (omit for all). Options: agent_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