Read a staged upload's progress — the resume read

GET

/api/blobs/uploads/{id}

Maintainer:Not configured

OperationId:blob_upload_progress

Returns the currently-landed segment set and the running byte total: the values a
finalize echoes back as its concurrency tokens. The staging is caller-private until
finalized — another profile's session answers 404, the same absent-not-refused posture
every visibility gate renders.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Header Params

Responses

🟢200OK

application/json

The currently-landed segment set

Bodyapplication/json

🟠401Unauthorized

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/blobs/uploads/' \
--header 'X-Temper-Surface;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "segments": [
        {
            "segment_bytes": 0,
            "segment_hash": "string",
            "seq": 0
        }
    ],
    "total_bytes": 0,
    "upload_id": "f2ef591b-135b-46fa-a604-3d4fda5bfbfb"
}

Modified at 2026-09-16 12:46:48

Begin a segmented upload — declare the home and media type, get the session id

Finalize a staged upload — assemble, hash, commit