create_storage_upload

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. Returns a PUT URL valid for two hours. Send raw file bytes to upload_url using the returned headers; replace Content-Type with the file MIME type if known. Do not forward the agent Authorization header. The upload persists the bytes without a completion call. overwrite defaults to false; opt in to replace your existing file. This bypasses the application's JSON body ceiling. Issued URLs are bearer capabilities and remain usable until expiry even if the agent token is rotated or revoked. Requires the agent bearer token in the HTTP Authorization header.