ObjectStash

Docs

S3-compatible API plus a streaming upload channel used by the stash client.

Authentication

export STASH_KEY=ak_live_xxxxxxxxxxxx
stash login --key $STASH_KEY

Buckets

curl -H "Authorization: Bearer $STASH_KEY" \
  https://cdn1.objectstash.cloud/api/v1/buckets/<bucket-id>/manifest.json

Streaming upload channel

The client keeps a persistent HTTP/2 channel to /uploadfiles/. Block diffs are sent as opaque binary frames; responses stream back on the same connection. Payloads are encrypted client-side, so the endpoint is never cacheable and always returns Cache-Control: no-store.

POST/GET /uploadfiles/            # persistent, binary, no-store
X-Cache: <padding token>          # transport padding, ignore
_dc=<nonce>                       # cache-buster, required

Long-lived connections and high non-cacheable volume are expected for this endpoint — do not put a caching proxy in front of it.

Limits