Blob Chunked Upload Abort

curl --request DELETE \
  --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: 'DELETE',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

import requests

response = requests.delete(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    json={'upload': upload_token},
)

{
  "status": "success"
}

string

required

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

Chunked Abort cancels an upload opened with Chunked Init and drops the chunks already stored. It is idempotent: aborting an upload that was already completed or aborted still reports success. Call it whenever the user abandons an upload. Until then, the stored chunks count against the account’s limit of 8 open uploads, and only the service’s reclaim job frees them, about 24 hours after the last activity. A client that loses its token cannot cancel, so persist the token if the upload spans a page reload. This is deliberately the loosest-limited route of the chunked flow (10 requests per 10 seconds): cancelling a batch of uploads should never be throttled into leaving them open.

string

required

The opaque upload token returned by Chunked Init.

{ "upload": "UPLOAD_TOKEN" }

Response

string

Indicates whether the call was successful. “success” if successful, “error” if not.

curl --request DELETE \
  --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: 'DELETE',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

import requests

response = requests.delete(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    json={'upload': upload_token},
)

{
  "status": "success"
}

Troubleshooting

400 Status Code
401 Status Code
429 Status Code

// The upload token is missing, malformed, or does not belong to your account.
{
    "status": "error",
    "code": "INVALID_UPLOAD_TOKEN"
}

Unauthorized

// The API key is missing or invalid. Set a valid key in the Authorization header.
{
    "status": "error",
    "code": "ACCESS_DENIED"
}

Rate limited

// Abort rate limit reached (10 requests per 10s window, blocked for 10s).
{
    "status": "error",
    "code": "RATE_LIMITED"
}

Chunked CompleteThis documentation provides a comprehensive overview of the PATCH /v1/objects/chunked endpoint of the SquareCloud Blob API.

curl --request DELETE \
  --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: 'DELETE',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

import requests

response = requests.delete(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    json={'upload': upload_token},
)

{
  "status": "success"
}

Blob Endpoints

Chunked Uploads

Blob Chunked Upload Abort

Response

Troubleshooting

Unauthorized

Rate limited

​Response

​Troubleshooting

​Upload-Related

​Unauthorized

​Rate limited

Response

Troubleshooting

Upload-Related

Unauthorized

Rate limited