POST /storage/uploads/{upload_id}/commit
Validate an upload (commit)
Exact scope storage:write. No body. The server inspects the observed metadata: size and SHA-256 must be exactly those announced at begin. 201 when the object is created, 200 on replay. Hidden surface: 404 not_found until the Galon Object opt-in is enabled and a qualified data plane is injected. No bytes pass through the API; no internal reference or provider name is returned.
API key (Bearer), on the public API endpoint.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
upload_id | path | string · required |
Responses
| Status | Description | Body |
|---|---|---|
201 | Object available | StorageUploadCommit |
200 | Idempotent replay | StorageUploadCommit |
400 | body_not_allowed | Error |
401 | Key missing or invalid | Error |
403 | scope_missing (storage:write) | Error |
404 | storage_object_not_found (unknown upload), not_found | Error |
412 | storage_precondition_failed (nothing received, size differs) | Error |
422 | storage_checksum_mismatch | Error |
503 | storage_operation_indeterminate, storage_response_lost: replay the commit | Error |
Examples
curl
curl -X POST "$GALON_API_BASE/storage/uploads/<upload_id>/commit" \
-H "Authorization: Bearer $GALON_API_KEY"Node.js (SDK)
import { Galon } from "galon";
const galon = new Galon(process.env.GALON_API_KEY);
const result = await galon.uploads.commit("<id>");Python (SDK)
from galon import Galon
galon = Galon() # reads GALON_API_KEY
result = galon.uploads.commit("<id>")