Route reference
These compatibility routes describe the public wrapper surface behind the direct WavebirdClient integration. New Server API examples should start with /v1/placements instead.
Public API boundary
These compatibility routes describe the public wrapper surface behind the direct WavebirdClient integration. New Server API examples should start with /v1/placements instead.
| Method | Route | Notes |
|---|---|---|
POST | /public/wrapper/v1/jobs | createJob() submits wrapper jobs here. Supplying callback_url opts the job into callback delivery. |
GET | /public/wrapper/v1/slots/{slot_id}/decision | Polling decision retrieval path used by getDecision() when polling is selected or used as fallback. |
GET | /public/wrapper/v1/slots/{slot_id}/decision/ws | Explicit WebSocket decision-delivery path. The SDK falls back to polling on connection, parse, close, or timeout failures. |
POST | /public/wrapper/v1/jobs/{job_id}/generation | reportGeneration() reports started, finished, and failed lifecycle events here. |
POST | /public/wrapper/v1/beacons | sendBeacon() submits rendered, visible_started, visible_ended, clicked, and related public wrapper beacon types here. |
This page is limited to the public wrapper routes used by WavebirdClient. They remain documented for SDK and migration compatibility, but they are not the shortest Server API flow.
This page is intentionally limited to the public `/public/wrapper/v1/*` routes used by `WavebirdClient` for SDK compatibility.
New Server API integrations should start with `/api/quickstart` and `/v1/placements`; proxy compatibility remains documented on the dedicated pattern page. Questions? Ask about integration.
Choose hosted defaults or package control
These pages document the package layer for teams that choose wavebird to control ad requests, decisions, rendering helpers, consent, and beacons directly. Use the API docs for hosted defaults, and use contact only when you want rollout review, enterprise coordination, or help with non-standard integration constraints. Beacon billing rules live in SDK Concepts.