Axuz Developers

DELETE /me/api-tokens/{tokenID}

Faz soft-revoke (revoked_at = now()) de um token do caller.

  • Acesso: Login
  • Serviço: https://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`.

Entradas: userID do JWT; {tokenID} pela URL.

Retorno: 204 no sucesso; 400 tokenID inválido; 401 sem auth; 404 se não existe ou já foi revogado (não distingue os dois pra evitar enumeração cross-user); 500 em erro de DB.

Parâmetros

NomeEmTipoObrigatórioDescrição
tokenIDpathstringsim

Respostas

200

TBD

400

TokenID inválido

NomeTipoObrigatórioDescrição
errorstringsim

401

Sem credencial valida

NomeTipoObrigatórioDescrição
errorstringsim

404

Se não existe ou já foi revogado (não distingue os dois pra evitar enumeração cross-user)

NomeTipoObrigatórioDescrição
errorstringsim

429

Limite de requisições excedido.

NomeTipoObrigatórioDescrição
errorstringsim

500

Em erro de DB

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://api.axuz.net/me/api-tokens/TOKEN_ID' \
  -H "Authorization: Bearer $AXUZ_TOKEN"

Node.js

const res = await fetch("https://api.axuz.net/me/api-tokens/TOKEN_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://api.axuz.net/me/api-tokens/TOKEN_ID",
    headers={
        "Authorization": f"Bearer {os.environ['AXUZ_TOKEN']}",
    },
    timeout=30,
)
res.raise_for_status()
print(res.json())