snapshots

Get Snapshot Progress

Live progress for one snapshot, shaped for polling.

This exists so the browser stops reading the snapshots table directly. That read gave the client a standing view of every column the table will ever grow, and pinned the poll's shape to a frontend deploy.

Read-only and cheap by construction: one narrow projection, no row cache, no per-caller computation. Rate limiting is the global SlowAPI backstop -- tier_rate_limit depends on get_current_user and would refuse the anonymous viewers who can legitimately watch a public repo index.

get/snapshots/{snapshot_id}/progress

Path parameters

snapshot_idstring required

Response

Successful Response

snapshot_idstring required
short_idstring required
status'queued' | 'indexing' | 'ready' | 'failed' required
error_messagestring nullable
created_atstring date-time required
completed_atstring date-time nullable
server_timestring date-time required
elapsed_secondsinteger required
stale_after_secondsinteger required
is_staleboolean required
stagestring nullable
currentinteger nullable
totalinteger nullable
cost_centsinteger nullable
docs_statusstring nullable
docs_pages_readyinteger nullable
docs_pages_totalinteger nullable
docs_pages_reusedinteger nullable
embeddings_statusstring nullable
file_countinteger nullable
expected_secondsinteger nullable

Changes

No recorded changes to this endpoint across all 1 revision of this API.