Skip to main content
Archive download is useful for CI pipelines, offline processing, and environments where adapters are not available.

Fast path: download.sh

Or download and run locally:
Script options:

Manual API flow

Request a presigned URL:
Rules:
  • Shelf must be ready or review
  • ttl range is 60 to 3600 seconds
  • Default ttl is 300
The first request may start archive preparation, so use short polling loops in automation. If archive is not ready yet, you get 202:
Poll after retryAfter seconds until 200, then download from returned url. On 401, refresh credentials. On 409, wait for an eligible shelf status (ready or review) before retrying.

Verify integrity

Use sha256 from the 200 response:
download.sh performs verification automatically when a SHA-256 tool is available.

Choosing retrieval mode

  • Archive: CI/offline snapshots
  • Sandbox adapters: provider-native runtime hydration
  • JSON tree: in-memory workflows
  • Single file: targeted reads
For reproducible jobs, log the returned version timestamp with your build metadata.