What it does
Write every file staged through one create_upload_urls batch as one draft version. Refused, writing nothing, when a file of the batch was not sent (validation_failed reason batch_incomplete, details.missing lists the names), when the batch was already committed (batch_committed) or is past commit_by (batch_expired). Optional base_version must equal the current draft version, or the call fails with validation_failed reason version_conflict. A name already on the site is replaced. uploaded in the response lists each file (name, url, content_type, size_bytes, sha256); files lists what changed in the draft, as for every write. Visitors see nothing until publish_site.
Plans
Works on every plan: Free, Basic, Pro and Ultra.
Parameters
| Name | Type | About |
|---|---|---|
site_idrequired | string | The id of the site. list_sites gives the ids of your sites. |
batch_idrequired | string | The batch_id create_upload_urls returned. Every file of the batch must have been sent. |
base_version | integer | Optional: the current draft version. Another number fails with version_conflict. |
message | string | A short note for the version history, like a commit message. |
verbose | boolean | true lists every file and page of the draft. Otherwise the response lists only what this call changed, plus draft totals. |
idempotency_key | string | Any unique string (1-200 printable ASCII). A retry with the same key and arguments returns the first call's result instead of running again. Same as the Idempotency-Key header. |
Example
Call commit_uploads with these arguments:
{
"site_id": "01a1…",
"batch_id": "01a1…"
}
Ids like 01a1… stand for your own. list_sites and list_tables give you the real ones.
Related guides
- Images, fonts, PDFs and videoUpload files and use them on your pages.