Caché

Purga la caché del borde de una zona y sigue hasta dónde ha llegado cada purga. Una purga llega a los nodos del borde en un segundo aproximadamente; queda en la auditoría, no como versión de configuración.

#Purgar la caché

POST /v1/orgs/{org}/zones/{zone}/cache/purge

Purga lo que el borde guardó en caché para la zona. El cuerpo lleva exactamente uno de purge_everything (true), files (URL, u objetos {"url": …}; se purgan todas las variantes de cada URL), prefixes (nombre/ruta), hosts o tags (valores de Cache-Tag), con como mucho 100 valores. Los valores se normalizan (esquema y nombre en minúsculas, sin el puerto por defecto ni el fragmento, ruta canónica) y sus nombres deben ser de la zona.

Los nodos del borde aplican la purga en un segundo aproximadamente. Una purga no es una versión de configuración: queda en la auditoría con su motivo. Por organización, 10 purgas por minuto con ráfagas de 30 para todo, nombres, prefijos y etiquetas, y 500 URL por minuto. Con dry_run=1 solo se valida y normaliza, y no cuenta para el límite.

Rol necesario: tech o superior. También lo pueden llamar los tokens de la zona que solo purgan la caché.

Controles de cambio: dry_run · X-Change-Reason (opcional)

#Parámetros

#Cuerpo de la petición

Tipo de contenido application/json. Esquema: PurgeRequest.

Exactamente uno de los campos

#Respuesta

• 200: Purga aceptada (o simulada). Devuelve PurgeResult.

#Errores

#Ejemplo

curl -X POST "https://dash.openwaf.dev/v1/orgs/$OPENWAF_ORG/zones/6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d/cache/purge" \
  -H "Authorization: Bearer $OPENWAF_TOKEN" \
  -H "X-Change-Reason: Deploy of the new home page" \
  -H "Content-Type: application/json" \
  --data '{
    "files": [
      "https://www.example.com/index.html"
    ]
  }'

import { OpenWAF } from "./openwaf";

const owf = new OpenWAF({ baseUrl: "https://dash.openwaf.dev" }); // token de OPENWAF_TOKEN
const result = await owf.purgeCache({
  zone: "6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d",
  body: {
    files: [
      "https://www.example.com/index.html"
    ]
  }
}, {
  reason: "Deploy of the new home page"
});

from openwaf import OpenWAF

owf = OpenWAF(base_url="https://dash.openwaf.dev")  # token de OPENWAF_TOKEN
result = owf.purge_cache(
    zone="6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d",
    body={
        "files": [
            "https://www.example.com/index.html"
        ]
    },
    reason="Deploy of the new home page",
)

{
  "dry_run": false,
  "seq": 0,
  "kind": "everything",
  "values": [
    "https://www.example.com/index.html"
  ],
  "epoch": 0,
  "created_at": "2026-10-27T09:30:00Z",
  "warnings": []
}

#Listar purgas

GET /v1/orgs/{org}/zones/{zone}/cache/purges

Lista las purgas de los últimos 7 días, de la más reciente a la más antigua, con cuántos de los nodos activos con caché que sirven la zona (nodes) han aplicado ya cada una (applied).

Rol necesario: readonly o superior.

#Parámetros

#Respuesta

• 200: Devuelve items, un array de PurgeStatus.

#Errores

#Ejemplo

curl "https://dash.openwaf.dev/v1/orgs/$OPENWAF_ORG/zones/6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d/cache/purges" \
  -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.listCachePurges({
  zone: "6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d"
});

from openwaf import OpenWAF

owf = OpenWAF(base_url="https://dash.openwaf.dev")  # token de OPENWAF_TOKEN
result = owf.list_cache_purges(zone="6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d")

{
  "items": [
    {
      "seq": 0,
      "zone_id": "6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d",
      "kind": "everything",
      "values": [
        "https://www.example.com/index.html"
      ],
      "actor": "token:11111111-2222-4333-8444-555555555555",
      "created_at": "2026-10-27T09:30:00Z",
      "nodes": 0,
      "applied": 0
    }
  ]
}