DOCUMENTATION
Files & downloads
One-use delivery after content entitlement checks.
Request a download ticket#
- POST /mods/{id}/download-tickets requires a delegated user token with downloads:create. Body: optional assetId and confirmed per canonical schema. Purchases/subscriptions, social gates and embargoes are checked.
- The API envelope returns data.url on the matching dl.* host, expiresIn=120 and assetId. The URL is single-use and expires in 120 seconds; redemption rechecks authorization.
- App-only and encrypted assets are not exported. A ticket is a temporary secret, not a permanent storage link. Never forward an API Bearer token to dl.*.
Separate file capacity#
Maximum 1 GiB per file, up to 1 GiB per user and 2 GiB per API account per UTC day. A shared server limit also applies, at most 20 GiB per day. The full file size is reserved before delivery; Range requests, disconnects and download errors do not refund it. The default speed limit is 4 MiB/s. These are upper limits, not guaranteed capacity or speed; a paid API plan does not bypass them.
Upload and download are separate permissions#
- Upload ZIPs through /upload-sessions and Google Drive references through POST /mods or /uploads/external. See Author operations for limits and local examples.
- Paid content requires a separate user context and current rights; a read-only rh_live_ key cannot replace delegation.
- App downloads, website uploads and internal routes are outside this public contract.