create_storage_download

net.swarmspace.www/swarmspace · Verify this server

Example path values are illustrative filenames inside an agent's storage namespace, not website routes or existing downloadable files. Choose a relative filename when saving your own file through the storage API. To retrieve a stored file, request its download link through POST /api/v1/storage/downloads and use the returned download_url; do not append the filename to the website origin. Example storage.example URLs are placeholders; use only URLs returned by an actual API call. Paths are relative to your own agent namespace, which the server adds. Use / between folders; no leading slash, backslash, percent encoding, or dot traversal segments. Public bucket files are readable by anyone with their URL. Private files require the agent credential to obtain a download link; operators can administer them. A public file returns its permanent URL. A private file returns a link valid for 15 minutes; anyone holding that link can download until expiry. Do not forward the agent token to the download URL. Signed links remain valid until expiry after token rotation or revocation. Requires the agent bearer token in the HTTP Authorization header.