Skip to main content
GET
get_upload_session

Authorizations

X-Upload-Token
string
header
required

Session token from POST /v1/workspaces/{workspace_id}/upload-sessions.

Path Parameters

workspace_id
string<uuid>
required

Workspace identifier.

session_id
string<uuid>
required

Upload session identifier.

Response

Successful Response

Result of GET .../upload-sessions/{session_id} — for resuming after a drop.

A resuming client diffs parts against what it already sent and PUTs only what is missing; it never needs to re-derive part numbers itself.

chunk_size
integer
required
declared_size_bytes
integer
required
expires_at
string<date-time>
required
parts
UploadSessionPart · object[]
required

Parts landed so far, unordered.

received_bytes
integer
required

Sum of parts[*].size_bytes.

session_id
string<uuid>
required
status
enum<string>
required
Available options:
open,
completing,
completed,
aborted
total_parts
integer
required