Pular para o conteúdo principal
DELETE
Excluir objeto de blob pelo ID
Exclui permanentemente um objeto de blob e libera o seu armazenamento. A exclusão não pode ser desfeita, e não há backup. A resposta é null no campo response. Escopo: blob:write.
string
obrigatório
O ID do objeto.
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

Vazia em caso de sucesso.

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.
  • BLOB_OBJECT_NOT_FOUND (404): não existe objeto com esse ID nesta conta (ou no blob do workspace).
Última modificação em 28 de outubro de 2026