v1

latestOpenAPI 3.0.2Apache-2.02026-07-142963051.0 MB

Uploads (Chunked)

Upload part of file

Uploads a chunk of a file for an upload session.

The actual endpoint URL is returned by the Create upload session and Get upload session endpoints.

put/files/upload_sessions/{upload_session_id}

Path parameters

upload_session_idstring required

The ID of the upload session.

Headers

digeststring required

The RFC3230 message digest of the chunk uploaded.

Only SHA1 is supported. The SHA1 digest must be base64 encoded. The format of this header is as sha=BASE64_ENCODED_DIGEST.

To get the value for the SHA digest, use the openSSL command to encode the file part: openssl sha1 -binary <FILE_PART_NAME> | base64.

content-rangestring required

The byte range of the chunk.

Must not overlap with the range of a part already uploaded this session. Each part’s size must be exactly equal in size to the part size specified in the upload session that you created. One exception is the last part of the file, as this can be smaller.

When providing the value for content-range, remember that:

The lower bound of each part's byte range must be a multiple of the part size.
The higher bound must be a multiple of the part size - 1.

Response

Chunk has been uploaded successfully.

Example response

{
  "part": {
    "part_id": "6F2D3486",
    "offset": 16777216,
    "size": 3222784,
    "sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc"
  }
}