Arquivos
Excluir um arquivo
Remove um arquivo.
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 headerOrganization 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.

