files

get_upload_session

Read a chunked upload's lifecycle state and landed parts. Cost class: fast.

The resume entry point: after a dropped connection (or a page reload), diff parts against what was already sent and PUT only what is missing — never re-derive part numbers, and never resend a part that already landed.

Args: auth: The resolved session context and row.

Returns: An :class:UploadSessionStatusResponse.

get/v1/workspaces/{workspace_id}/upload-sessions/{session_id}

Request

Path parameters

workspace_idstring uuid required

Workspace identifier.

session_idstring uuid required

Upload session identifier.

Response

Successful Response

session_idstring uuid required
status'open' | 'completing' | 'completed' | 'aborted' required
chunk_sizeinteger required
total_partsinteger required
received_bytesinteger required

Sum of parts[*].size_bytes.

declared_size_bytesinteger required
expires_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.