Complete a chunked upload

curl --request PATCH \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "upload": "UPLOAD_TOKEN" }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/chunked', {
  method: 'PATCH',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "size": 2147483648,
    "parts": 128
  }
}

string

required

The API key for your account. You can find this in your account settings.

Chunked Complete assembles the parts sent with Chunked Part into the final file. The part list is read on the server, so you only send the upload token. Once it answers, the file is stored and counts against your quota. Requires the blob:write scope, or the upload token that opened the upload, and an active plan. What happens on a refusal depends on the cause:

The upload is kept open when the account has no active plan (PERMISSION_DENIED), is over its quota (STORAGE_QUOTA_EXCEEDED) or storage is unavailable (503). Fix the cause and call Complete again, without re-sending any part.
The upload is aborted and its parts are discarded when the file is smaller than 512 bytes (FILE_TOO_SMALL) or larger than its limit (FILE_TOO_LARGE).
Nothing changes when no part was sent yet (NO_CHUNKS_UPLOADED) or a part other than the last is under 5 MB (CHUNK_TOO_SMALL): re-send that part and complete again.

Parameters

string

required

The upload token returned by Chunked Init. It can also go in the upload query parameter.

Rate limits

5 requests per 10 seconds, so several parallel uploads can finish together (RATE_LIMITED, 429).

Response

string

“success” if successful, “error” if not.

object

Show Toggle object

string

The id of the stored file.

boolean

Whether the file is private.

string | null

The public URL, or null for private files.

ISO 8601

When the file will be deleted. Present only when it expires.

number

The size of the file, in bytes.

number

How many parts were assembled.

curl --request PATCH \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "upload": "UPLOAD_TOKEN" }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/chunked', {
  method: 'PATCH',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "size": 2147483648,
    "parts": 128
  }
}

Errors

Code	HTTP	When
`INVALID_UPLOAD_TOKEN`	400	The `upload` token is missing, malformed or not yours.
`NO_CHUNKS_UPLOADED`	400	No part was sent yet.
`CHUNK_TOO_SMALL`	400	A part other than the last has less than 5 MB.
`FILE_TOO_SMALL`	400	The file has less than 512 bytes. The upload is aborted.
`PERMISSION_DENIED`	401	The account has no active plan. The upload stays open.
`STORAGE_QUOTA_EXCEEDED`	403	The file would pass the included storage. The upload stays open.
`UPLOAD_NOT_FOUND`	404	The upload was completed, aborted or expired.
`FILE_TOO_LARGE`	413	The file passes its size limit. The upload is aborted.
`RATE_LIMITED`	429	More than 5 requests in 10 seconds.
`UPLOAD_FAILED`	500	The assembly failed. Retry.
`PRIVATE_STORAGE_UNAVAILABLE` / `PUBLIC_STORAGE_UNAVAILABLE`	503	Storage is temporarily unavailable. The upload stays open.

Blob SDK: blob.put() runs the whole chunked flow for files above 90 MiB

curl --request PATCH \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "upload": "UPLOAD_TOKEN" }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/chunked', {
  method: 'PATCH',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "size": 2147483648,
    "parts": 128
  }
}

Get started

Objects

Chunked uploads

Account

Share links

S3

Complete a chunked upload

Parameters

Rate limits

Response

Errors

​Parameters

​Rate limits

​Response

​Errors

​Related

Parameters

Rate limits

Response

Errors

Related