API Reference

The Cedrix Edge API is HTTPS + HTTP/2. Management calls are REST; the event and log feeds are long-lived bidirectional gRPC streams. All requests require a bearer token.

Authentication

Send your API token in the Authorization header. Tokens are scoped per zone and can be rotated from the console.

# every request
Authorization: Bearer ck_live_9f2a…

Base URL

The API is served from this edge node, the zrh1 region. All calls go to this host over HTTPS.

Purge by tag POST

POST /v1/cache/purge
{ "tags": ["release-2026-07"] }

# 202 Accepted — clears the edge cache in < 1s

Event stream gRPC

Open one connection and receive hit, miss and purge events in order. The stream is bidirectional — send subscribe frames, receive events.

POST /sync.v1.Events        # HTTP/2, content-type application/grpc
Authorization: Bearer <token>

→ { "subscribe": { "pop": "zrh1", "events": ["purge"] } }
← { "purge": { "tag": "release-2026-07", "objects": 1841 } }

Real-time logs

Structured request logs stream to the same channel or to a bucket/webhook sink configured per zone.