Pular para o conteúdo principal
DELETE
Excluir vários objetos de blob ou uma pasta
Exclui até 1.000 objetos em uma chamada, seja por ids ou por prefix de pasta. Envie exatamente um dos dois. A exclusão é permanente. Quando há mais objetos que correspondem a um prefix, remaining é true; chame de novo até que seja false. Escopo: blob:write.
string[]
IDs de objetos, até 1.000. Não envie junto com prefix.
string
Exclui todos os objetos cujo caminho começa com este prefixo de pasta, até 1.000 por chamada. Não envie junto com ids.
string
O ID do workspace, quando o blob pertence a um workspace. A chamada atua sobre o blob do proprietário do workspace e exige a permissão blob:read do workspace (blob:manage nas rotas que alteram dados). Deixe de fora para atuar sobre o seu próprio blob.

Exemplo de requisição

Resposta

object
O que foi excluído nesta chamada.

Respostas de erro

string
O código de erro que indica o motivo da falha. Valores possíveis:
  • AUTH_TOKEN_MISSING (401): o cabeçalho Authorization não foi enviado.
  • API_KEY_INVALID (401): a chave de API não existe, foi revogada ou o segredo não confere.
  • API_KEY_SCOPE_DENIED (403): a chave não tem o escopo que esta rota exige (blob:read ou blob:write); details.required informa qual.
  • WORKSPACE_PERMISSION_DENIED (403): somente com workspace_id: você não é membro, ou o seu papel não tem a permissão de blob.
  • WORKSPACE_NOT_FOUND (404): somente com workspace_id: não existe workspace com esse ID, ou você não é membro.
  • VALIDATION_ERROR (400): um parâmetro ou campo do corpo falhou na validação. details.path informa o campo.
Última modificação em 28 de outubro de 2026