Galon Cloud
Galon API v1

/storage/uploads/{upload_id}/commit

Base URL https://api.galon.ai/v1 · export GALON_API_BASE="https://api.galon.ai/v1"

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

NameInTypeDescription
upload_idpathstring · required

Responses

StatusDescriptionBody
201Object availableStorageUploadCommit
200Idempotent replayStorageUploadCommit
400body_not_allowedError
401Key missing or invalidError
403scope_missing (storage:write)Error
404storage_object_not_found (unknown upload), not_foundError
412storage_precondition_failed (nothing received, size differs)Error
422storage_checksum_mismatchError
503storage_operation_indeterminate, storage_response_lost: replay the commitError

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>")