Upload sessions

Returns your upload sessions that are still open, newest first (up to 200), so an interrupted upload can be found and resumed. Finished and cancelled sessions are not listed. Capped at 60 requests per minute per account across the upload session routes and the duplicate check; these routes do not use up the hourly account request budget. Available to free and paid accounts.

Starts a resumable upload for a file of any size up to 10 GiB (1 GiB for MP4 or MOV video). The file is sent in parts of part_size_bytes (16 MiB; the last part is smaller), at most 10000 parts. The flow is: create the session, ask for part URLs, PUT each part to its URL (parts can go in parallel and be retried), then complete the session. A session you do not finish can be resumed by reading its status, and is cleaned up 7 days after it started.

Creating a session reserves the declared size in your storage at once, so a file that would not fit is refused here with 413 storage_quota_exceeded. At most 50 sessions started in the last 60 minutes can be unfinished at the same time. If you send sha256, repeating the same request (same hash, filename, size and version_of) within 5 minutes returns the open session instead of starting a second one, which makes a lost response safe to retry. Capped at 60 requests per minute per account across the upload session routes and the duplicate check; these routes do not use up the hourly account request budget. Available to free and paid accounts.

Returns the state of one session, with the parts storage has actually received, so an interrupted upload resumes by sending only the missing parts. Capped at 60 requests per minute per account across the upload session routes and the duplicate check; these routes do not use up the hourly account request budget. Available to free and paid accounts.

Cancels an unfinished session: the parts are discarded and the storage reserved for the file is released. Cancelling a session that is already cancelled succeeds again; one that already completed returns 409 session_not_uploading (delete the file instead). Capped at 60 requests per minute per account across the upload session routes and the duplicate check; these routes do not use up the hourly account request budget. Available to free and paid accounts.

Assembles the uploaded parts into the file. Every part must be uploaded with the right size and the total must match the size you declared. The bytes are then checked: a file that is not audio is removed and refused with 415 not_audio. On success the file is ready in your library. Completing a session that already completed returns the same result, so the call is safe to retry.

Optionally add tags (merged with the ones from the start), change version_of, or give client_duration_seconds. Capped at 60 requests per minute per account across the upload session routes and the duplicate check; these routes do not use up the hourly account request budget. Available to free and paid accounts.

Returns one upload URL per requested part, at most 20 per call. Send each part's bytes with a PUT to its url, exactly as returned and with no API key (the URL is the credential), within 60 minutes. A part is exactly part_size_bytes long except the last one. A part can be sent again; the last copy wins. Ask again for fresh URLs if they expire. URLs are opaque: do not parse them. Capped at 60 requests per minute per account across the upload session routes and the duplicate check; these routes do not use up the hourly account request budget. Available to free and paid accounts.

Fallback target of a part URL. When a URL from the part-urls route points at this API instead of at storage, send the part bytes to it exactly as returned: it already carries the one-time t token, which is the credential, so there is no API key. The request needs a Content-Length header (without one it is refused with HTTP 411 missing_content_length) and a body no larger than part_size_bytes. Most accounts receive storage URLs and never call this route.