GET /snapshot/:agent_id/latest
Retrieve the metadata and storage URL for the most recent confirmed snapshot of a given agent.Response — 200 OK
Client-supplied payload hash recorded at upload time — re-derive and compare this before trusting the decrypted payload.
curl Example
GET /snapshot/:agent_id/:sequence
Retrieve metadata and the storage URL for a checkpoint at a specific sequence number. Use this for rollbacks, audits, or debugging a particular checkpoint in the agent’s history.Response — 200 OK
The response schema is identical toGET /snapshot/:agent_id/latest above — a receipt object and a ciphertextUrl. Returns 404 snapshot_not_found if no confirmed snapshot exists at that exact sequence number.
curl Example
GET /snapshot/:agent_id/lineage
Fetch an ordered list of confirmed sequence numbers, payload hashes, and storage paths for an agent. Use this to reconstruct the full parent-hash ancestry chain and verify historical integrity locally.
Query Parameters: