> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancelar um upload em partes

> Cancele um upload em partes e descarte as partes com DELETE /v1/objects/chunked. É idempotente e não exige plano ativo, então você sempre consegue limpar.

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

O Cancelar Upload cancela um upload aberto com o [Início de Upload em Partes](/pt-br/blob-reference/endpoint/chunked-init) e descarta as partes já enviadas, liberando um dos 32 uploads abertos da conta. Ele é idempotente: cancelar um upload que já foi concluído, cancelado ou expirou também responde com sucesso. Não é preciso ter um plano ativo, então você sempre pode fazer a limpeza. Exige o escopo `blob:write`, ou o token de upload que abriu o upload.

Uploads parados por 24 horas são cancelados automaticamente.

## Parâmetros

<ParamField body="upload" type="string" required>
  O token `upload` retornado pelo Início de Upload em Partes. Ele também pode ir no parâmetro de query `upload`.
</ParamField>

## Limites de taxa

<Note>10 requisições a cada 10 segundos (`RATE_LIMITED`, 429).</Note>

## Resposta

<ResponseField name="status" type="string">
  "success" se bem-sucedida, "error" caso contrário.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"system"}
  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" }'
  ```

  ```javascript JavaScript theme={"system"}
  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 }),
  });
  ```
</RequestExample>

<ResponseExample>
  ```json theme={"system"}
  {
    "status": "success"
  }
  ```
</ResponseExample>

## Erros

| Código | HTTP | Quando |
| - | - | - |
| `INVALID_UPLOAD_TOKEN` | 400 | O token `upload` está ausente, malformado ou não é seu. |
| `RATE_LIMITED` | 429 | Mais de 10 requisições em 10 segundos. |

## Relacionados

* SDK do Blob: [`blob.put()`](/pt-br/sdks/blob/uploads) executa todo o fluxo em partes para arquivos acima de 90 MiB


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.