Uploads

Complete an upload

After a successful PUT, POST the returned completion_url before expires_at. The token authorizes only this Upload; no API key, cookies, or request body is required. Verifies the stored object and commits one Source relationship. Valid retries return 204 without duplicate side effects. Retry network errors, 429, and 5xx responses with bounded backoff; never repeat the PUT just to retry completion.

POST

/api/uploads/completion/{token}

Path Parameters

token

string

required

Opaque completion capability from completion_url

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"

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.