La auditoría registra cada cambio de la organización, quien lo hiciera y desde cualquier interfaz. Las entradas se listan de la más reciente a la más antigua.
| Operación | Ruta |
|---|---|
| Listar la auditoría | GET /v1/orgs/{org}/audit |
Listar la auditoría
GET /v1/orgs/{org}/auditLista la auditoría de la organización, de la entrada más reciente a la más antigua. Para paginar, pasa en before el id de la última entrada recibida.
Rol necesario: admin o superior. De toda la organización. Un miembro o token tech limitado a un cliente lee las entradas de las zonas de su cliente.
Parámetros
| Nombre | En | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
org | ruta | string (uuid) | Sí | Id de la organización. Cada ruta comprueba que es la del token (si no, 404). |
limit | consulta | integer | No | Número máximo de elementos. Por defecto 100. De 1 a 500. |
before | consulta | integer | No | Paginación: id de la última entrada vista. |
Respuesta
200: Devuelveitems, un array de AuditEntry.
| Campo | Tipo | Descripción |
|---|---|---|
items[].id | integer | Id. |
items[].org_id | string (uuid) | Id de la organización. |
items[].actor | string | Quién hizo el cambio: un token, un usuario u OpenWAF. |
items[].action | string | |
items[].target | string | Objetivo de la acción. |
items[].data | object | Detalles del cambio. |
items[].at | string (date-time) | Fecha de la entrada. |
Ejemplo
curl "https://dash.openwaf.dev/v1/orgs/$OPENWAF_ORG/audit?limit=50" \
-H "Authorization: Bearer $OPENWAF_TOKEN"import { OpenWAF } from "./openwaf";
const owf = new OpenWAF({ baseUrl: "https://dash.openwaf.dev" }); // token de OPENWAF_TOKEN
const result = await owf.listAudit({
limit: 50
});from openwaf import OpenWAF
owf = OpenWAF(base_url="https://dash.openwaf.dev") # token de OPENWAF_TOKEN
result = owf.list_audit(limit=50)200
{
"items": [
{
"id": 48213,
"org_id": "1e7c9a3b-5d2f-4b8a-9c6e-0f2a4b6c8d1e",
"actor": "token:11111111-2222-4333-8444-555555555555",
"action": "record.update",
"target": "0c9a7e4d-2b1f-4e6a-8d3c-5f7b9a1c3e5d",
"data": {
"zone": "example.com",
"name": "www.example.com",
"reason": "Point www at the new origin"
},
"at": "2026-10-27T09:30:00Z"
}
]
}