DocsAPI referenceFiles

Read a multipart upload

Use upload_url of a multipart upload: its state and the parts received, to resume. No API key is required.

GET /v1/uploads/{id}

Needs no API key.

Parameters

Parameters
Name	In	Type
`id` required	path	string
`account` required	query	string
`expires` required	query	string
`signature` required	query	string

Request

bash

# From the answer of POST /v1/uploads with multipart: true. It needs no API key.
curl --fail-with-body -X GET "https://api.videxo.io/v1/uploads/up_0123456789abcdef01234567?account=acc_7Gq2x9LmTnV4&expires=1793822400&signature=example"

JavaScript

// `upload` is the answer of POST /v1/uploads with multipart: true. Its URLs need no API key.
const response = await fetch(upload.upload_url);
const { parts } = await response.json();

Response

200 JSON

{
  "id": "up_0123456789abcdef01234567",
  "state": "pending",
  "size_bytes": 250000000,
  "part_size_bytes": 8388608,
  "part_count": 30,
  "parts": [
    {
      "part_number": 1,
      "size_bytes": 8388608,
      "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
    }
  ],
  "input_url": "videxo://uploads/up_0123456789abcdef01234567",
  "upload_url_expires_at": "2026-11-04T18:00:00.000Z",
  "expires_at": "2026-11-05T12:00:00.000Z"
}

Responses

Responses
Status	Body	When
200	MultipartUploadStatus	The upload and its received parts.
403	Problem	permission_denied (link_invalid)
404	Problem	not_found (upload): unknown, deleted or aborted
410	Problem	resource_expired (upload_expired, link_expired)
429	Problem	rate_limited, with Retry-After in seconds