Axuz Developers

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

Soft-delete file + hard-delete storage

  • Access: Signed in
  • Service: https://files-api.axuz.net

Accepted authentication

  • 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.

This operation's description comes from the handler comment in the code (in Portuguese).

Parameters

NameInTypeRequiredDescription
teamIdpathstringyes
fileIdpathstringyes

Responses

200

OK

NameTypeRequiredDescription
okbooleanyes

401

Sem credencial valida

NameTypeRequiredDescription
errorstringyes

403

Sem permissão (ABAC/RBAC)

NameTypeRequiredDescription
errorstringyes

Chave/slug do erro

messagestringno

429

Limite de requisições excedido.

NameTypeRequiredDescription
errorstringyes

500

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

NameTypeRequiredDescription
errorstringyes

Examples

"Try it" is turned off in this reference. Use the examples with your test credential.

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())