Axuz Developers

DELETE /rooms/{id}

Encerra (hard delete) a sala.

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

Cascata em meet_participants (FK ON DELETE CASCADE). Invalida futuro mintToken. Só o criador pode (403 para quem vê a sala; 404 para quem não tem acesso, idêntico ao inexistente — W-012).

Parâmetros

NomeEmTipoObrigatórioDescrição
idpathstringsim

UUID da meet_room.

Respostas

200

Deletada.

NomeTipoObrigatórioDescrição
deletedbooleansim

400

Input inválido.

NomeTipoObrigatórioDescrição
errorstringsim

401

Cookie ausente ou inválido.

NomeTipoObrigatórioDescrição
errorstringsim

403

Autenticado mas sem permissão (ACL não passa).

NomeTipoObrigatórioDescrição
errorstringsim

404

Sala inexistente (ou privada, anti-enumeração).

NomeTipoObrigatórioDescrição
errorstringsim

429

Limite de requisições excedido.

NomeTipoObrigatórioDescrição
errorstringsim

500

Erro interno — inclui fail-loud MEET-02 quando membership lookup falha.

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://meet-api.axuz.net/rooms/ID' \
  -H "Authorization: Bearer $AXUZ_TOKEN"

Node.js

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