Purge API

Invalidate edge objects by exact URL or prefix after catalog or price changes.

Authentication

Send a property API key as a bearer token. Create keys under Dashboard → Property → API keys.

export DT8_API_KEY="dt8_live_****************"
export DT8_API="https://api.dt8cdn.net/v1"

Purge URLs

curl -sS -X POST "$DT8_API/purge" \
  -H "Authorization: Bearer $DT8_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.northwind.shop/products/linen-tee",
      "https://assets.northwind.shop/products/linen-tee/*"
    ]
  }'

Example response:

{
  "id": "pu_8f2a19c0",
  "status": "accepted",
  "propagated_ms": 118,
  "pops": 38
}

Purge by tag

If you set Cache-Tag: product-linen-tee on origin responses:

curl -sS -X POST "$DT8_API/purge" \
  -H "Authorization: Bearer $DT8_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tags": ["product-linen-tee", "collection-summer"]}'

Idempotency

Pass Idempotency-Key on purges from CI to avoid double work on retries.