Finalize a staged upload — assemble, hash, commit

POST

/api/blobs/uploads/{id}/finalize

Maintainer:Not configured

OperationId:finalize_blob_upload

Assembles the staged segments in seq order and runs the exact single-request commit
path: standing re-run (the gate the put answers to), concurrency tokens checked (409,
resumable), optional integrity hash checked (422 — the ingest precedent's face), the
readability-gated dedup pre-check, the provider put unless deduped, then the SQL
wrapper whose cap/allowlist refusals surface verbatim. Staging dies on success only —
every failure keeps it, resumable.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Committed (or dedup-hit) blob — the same shape the single-request path returns

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🟠409

🟠422Parameter Error

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/blobs/uploads//finalize' \
--header 'X-Temper-Surface;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "expected_content_hash": "string",
    "expected_segments": 0,
    "expected_total_bytes": 0
}'

Response Example

200 - Example 1

{
    "blob_id": "8249af2f-dd23-416e-b9c4-6cb13a792190",
    "content_bytes": 0,
    "content_hash": "string",
    "content_type": "string",
    "deduped": true,
    "estate_scope_disclosure": "string"
}

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

Read a staged upload's progress — the resume read

Append one segment to a staged upload — raw bytes as the request body