Save a data chunk to the destination environment

Request

For each chunk of content in a set within a transfer operation, use this endpoint to copy the chunk to the destination environment after using the corresponding Retrieve a specific chunk of transfer data endpoint, where you obtained a binary stream representing the chunk data.

Make this request in your destination environment.

Set the request header Content-Type: application/octet-stream.

Important

The request body for this endpoint must be the raw binary stream obtained from the response of the paired endpoint.

Do not alter, wrap, re-encode or chunk the stream; forward it exactly as received:

For media chunks, the client must send the compressed bytes as-is, with no decompression.
For content (non-media) chunks, the client must send the encrypted bytes as-is, with no decryption.

After retrieving and transferring all the chunks in a particular set, use the Complete a chunk set endpoint to generate a .raif file containing that chunk set's data on the destination environment.

Security

bearerAuth

Path

transferIdstring, (uuid)required

The unique identifier of the transfer operation. This is the UUID you provided when you created a content transfer operation.

chunksetIdstring, (uuid)required

The unique identifier of the chunk set that contains the chunk to be transferred. If you don't know this value, first retrieve details of a content transfer operation.

chunkIdinteger, (int32)required

The identifier of the chunk to be transferred.

Default:0

Example:0

Query

isMediabooleanrequired

Whether the chunk contains media content, affecting whether the data is compressed (media) or encrypted (non-media). For a given chunk, obtain this value from the IsMedia parameter in the Content-Disposition response header of the Retrieve a specific chunk of transfer data endpoint.

Bodyapplication/octet-streamrequired

The raw binary stream of chunk data obtained from the paired endpoint (Retrieve a specific chunk of transfer data). Must be forwarded exactly as received, without modification.

string, (binary)

curl -i -X PUT \
  'https://your-environment.sitecorecloud.io/sitecore/api/content/transfer/v1/transfers/{transferId}/chunksets/{chunksetId}/chunks/{chunkId}?isMedia=true' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/octet-stream' \
  -d string

Responses

Chunk was saved successfully.

Response

No content