Axuz Developers

DELETE /teams/{teamId}/files/{fileId}

Soft-delete file + hard-delete storage

  • Acesso: Login
  • Serviço: https://files-api.axuz.net

Autenticação aceita

  • sessionCookie — Sessão plena Axuz (cookie de sessão da casa). Sessão restrita é 403 enrollment_required.
  • bearerSession — JWT de acesso da sessão em `Authorization: Bearer`.

Fase 128 — hard-delete síncrono do primary storage. Trade-off: perde undo; ganha certeza que "apagou = sumiu". Réplicas secondary marcadas deleted + enfileiradas via file_purge no worker. Autorização: uploader OU team admin/owner.

A descrição desta operação vem do comentário do handler no código (em português).

Parâmetros

NomeEmTipoObrigatórioDescrição
teamIdpathstringsim
fileIdpathstringsim

Respostas

200

OK

NomeTipoObrigatórioDescrição
okbooleansim

401

Sem credencial valida

NomeTipoObrigatórioDescrição
errorstringsim

403

Sem permissão (ABAC/RBAC)

NomeTipoObrigatórioDescrição
errorstringsim

Chave/slug do erro

messagestringnão

429

Limite de requisições excedido.

NomeTipoObrigatórioDescrição
errorstringsim

500

Erro interno. Tente de novo com backoff; reporte o X-Request-Id.

NomeTipoObrigatórioDescrição
errorstringsim

Exemplos

O "Try it" está desligado nesta referência. Use os exemplos com a sua credencial de teste.

curl

curl -sS -X DELETE 'https://files-api.axuz.net/teams/TEAM_ID/files/FILE_ID' \
  -H "Authorization: Bearer $AXUZ_TOKEN"

Node.js

const res = await fetch("https://files-api.axuz.net/teams/TEAM_ID/files/FILE_ID", {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.AXUZ_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
console.log(await res.json());

Python

import os
import requests

res = requests.request(
    "DELETE",
    "https://files-api.axuz.net/teams/TEAM_ID/files/FILE_ID",
    headers={
        "Authorization": f"Bearer {os.environ['AXUZ_TOKEN']}",
    },
    timeout=30,
)
res.raise_for_status()
print(res.json())