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

# Excluir item

> Inicie a exclusão de um arquivo ou pasta do armazenamento.

Inicia a exclusão de um arquivo ou pasta do armazenamento.

A exclusão é assíncrona. A resposta `202` indica que a solicitação foi aceita e o item entrou em processamento de remoção.

<ResponseExample>
  ```json 202 theme={null}
  {
    "code": 202,
    "message": "Exclusão do arquivo iniciada.",
    "result": {
      "item_type": "file",
      "item_id": "9fcb573b-7f62-4774-978b-07e89dfef5f2"
    }
  }
  ```

  ```json 404 theme={null}
  {
    "code": 404,
    "message": "Arquivo não localizado."
  }
  ```

  ```json 409 theme={null}
  {
    "code": 409,
    "message": "Aguarde o upload em andamento antes de excluir esta pasta."
  }
  ```
</ResponseExample>

## Parâmetros

<ParamField path="item_type" type="string" required placeholder="file">
  Tipo do item.
</ParamField>

Valores aceitos:

| Valor    | Descrição               |
| -------- | ----------------------- |
| `file`   | Arquivo armazenado.     |
| `folder` | Pasta do armazenamento. |

<ParamField path="item_id" type="string" required>
  ID do arquivo ou pasta.
</ParamField>

## Resposta

| Campo       | Tipo     | Descrição                           |
| ----------- | -------- | ----------------------------------- |
| `item_type` | `string` | Tipo do item enviado para exclusão. |
| `item_id`   | `string` | ID do item enviado para exclusão.   |

## Regras importantes

* Ao excluir uma pasta, arquivos e subpastas internas também entram no fluxo de exclusão.
* Pastas com upload em andamento não podem ser excluídas até o upload finalizar ou falhar.
* Se houver falha ao remover objeto do storage, o item pode ficar com status `delete_failed`.