Downloads

Download a one-time (ephemeral) variant. This route exists for jobs submitted with delivery: ephemeral; it streams the produced bytes and deletes the object on a successful download. For drive delivery, variants carry a persistent url instead and you fetch that directly.

See the One-time results guide for the full flow.

---

Download a variant

GET /jobs/{id}/download/{variant}

Stream variant {variant} (0-based) of job {id}. Requires authentication; owner-scoped.

Behavior

• On a fully successful transfer, the object is deleted — the link is one-time.
• If the transfer is interrupted, the object is not deleted; retry within the hour.
• The response sets Content-Disposition: attachment; filename="<fileName>" using the variant's device-authentic name, plus the correct Content-Type.

Response — 200 OK

The raw variant bytes (image or video). Not JSON.

Errors

Status	error	When
410	gone	Already downloaded, or purged after the 1h fallback. The result is spent.
404	not_found	No such job/variant, or not yours.
409	not_ready	The variant hasn't finished yet — poll GET /jobs/{id} until it's completed.

Example

curl -s "$API/jobs/8f3c…/download/0" \
  -H "Authorization: Bearer $FLUIDGHOST_KEY" \
  -OJ   # honor the Content-Disposition filename

Retry only on network/5xx, never on 410. A 410 means a prior download already completed and consumed the result — retrying won't bring it back. Resubmit the job if you need the variant again. See One-time results.