Complete an upload

POST the returned completion_url before expires_at. Single-PUT Uploads send no body; multipart Uploads send every part number and storage ETag. Chunkify verifies the assembled object and atomically creates the Source and optional Asset. An Asset destination conflict returns 409 and fails the Upload without committing Source, Asset, or usage changes. Valid retries return 204 without duplicate side effects. Retry network errors, 429, and 5xx responses with bounded backoff.

POST

/uploads/completion/{token}

Path Parameters

token

string

required

Opaque completion capability from completion_url

Bodyapplication/json

Multipart Uploads send every part number and storage ETag. Single-PUT Uploads send no body.

parts

object[]

required

All uploaded parts in ascending part_number order, with the ETags returned by storage.

Responses

Upload completed or already completed. The response body is empty.

application/json

error

object

required

status

"error"

string

required

Status indicates the response status "error"

Invalid uploaded media or Upload is no longer waiting

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Invalid completion capability

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Storage permission or plan limit prevents completion

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Asset output folder conflicts with another Asset; Upload is failed

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Upload session expired or was deleted

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Rate limited; retry with backoff

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Temporary object verification failure; retry completion

// Use the completion_url returned when creating the Upload. const response = await fetch(upload.completion_url, { method: 'POST', credentials: 'omit', }); if (!response.ok) { throw new Error(`Completion failed: ${response.status}`); } // 204 No Content: do not call response.json().

import requests # Use the completion_url returned when creating the Upload. response = requests.post(upload["completion_url"], timeout=30) response.raise_for_status() # 204 No Content: there is no JSON response to parse.

<?php // Use the completion_url returned when creating the Upload. $request = curl_init($upload['completion_url']); curl_setopt_array($request, [ CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($request); $status = curl_getinfo($request, CURLINFO_HTTP_CODE); if ($result === false || $status !== 204) { throw new RuntimeException('Completion failed: ' . $status); } curl_close($request); // 204 No Content: there is no JSON response to parse.

// completionURL is the completion_url returned when creating the Upload. req, err := http.NewRequestWithContext(ctx, http.MethodPost, completionURL, nil) if err != nil { return err } client := &http.Client{Timeout: 30 * time.Second} resp, err := client.Do(req) if err != nil { return err } defer resp.Body.Close() if resp.StatusCode != http.StatusNoContent { return fmt.Errorf("completion failed: %d", resp.StatusCode) } // 204 No Content: there is no JSON response to decode.