Skip to main content
Remove um file da organização atuante. A remoção marca o arquivo como excluído, apaga o arquivo do Storage e limpa referências públicas conhecidas, como product.image_url e o avatar da organização ou da plataforma. Um kyc_document não pode ser excluído: a resposta é 400 invalid_request. Documento de identidade é o registro do cadastro financeiro da organização e fica retido mesmo depois de substituído. Para trocar o documento, aponte outro arquivo no bloco verification.document (ou verification.selfie) do update da organização. Um branding_logo ou branding_footer_logo ainda usado pela marca das páginas hospedadas — da organização ou de uma plataforma — não pode ser excluído: a resposta é 409 file_in_use. Troque o logo na configuração de marca do Dashboard e exclua o arquivo antigo depois. Um dispute_evidence não pode ser excluído: a resposta é 400 invalid_request. O arquivo pode estar referenciado por um campo de arquivo da defesa de uma disputa, e a defesa é registro permanente do caso. Para tirar um documento da defesa antes do envio, limpe o campo correspondente de evidence com string vazia ("") no update do dispute — o file em si permanece.

Autenticação

A API key da sua organização atua diretamente nela. Não envie o header Organization nesse caso.
Com Chargefy for Platforms, envie também Organization: org_... para excluir um arquivo de uma organização filha ativa da plataforma.

Parâmetros de caminho

string
obrigatório
ID do arquivo (file_*).

Resposta

200 OK com confirmação de remoção.

Erros comuns