Returns the current status of a specific cache, including execution details for both the last incremental sync and the last full refresh.
The top-level status field is computed from the most recent execution across both sync types:
NOT_INITIALIZED: No sync has ever been executed for this cache.RUNNING: At least one sync (incremental or full refresh) is currently in progress.COMPLETED: The most recent sync completed successfully.FAILED: The most recent sync failed. Check the error field in the relevant execution info for details.CANCELLED: The most recent sync was cancelled via a cancel endpoint.Each execution info object (lastIncrementalCacheExecution, lastFullRefreshCacheExecution) contains:
id: Unique execution identifier.status: Execution-specific status (RUNNING, COMPLETED, FAILED, CANCELLED).progress: Real-time progress with record counts (cached, inserted, updated, deleted).error: Error details if the execution failed.createdAt, updatedAt, finishedAt: Timestamps tracking execution lifecycle.Use excludeLogs=true to omit the cacheActionLogs array for a lighter response, especially when polling for status during an active sync.


Use the Authorization header with the value 'Bearer
The unique identifier of the project that owns the cache
The unique identifier of the cache to check (UUID format)
When true, omits the cacheActionLogs array from the response for a lighter payload. Defaults to false.
Cache status retrieved successfully.
The ID of the cache.
The status of the cache. RUNNING, CANCELLED, FAILED, COMPLETED, DELETED, NOT_INITIALIZED
RUNNING, CANCELLED, FAILED, COMPLETED, DELETED, NOT_INITIALIZED The ID of the catalog that the cache belongs to.
The name of the schema that the cache belongs to.
The name of the table that the cache belongs to.
The list of cache action logs
The ID of the project that the cache belongs to.