SDK methods

Jobs, decisions, generation events, and beacons with typed fail-silent returns and onError callbacks.

createJob(params)

Creates an ad opportunity through POST /v1/jobs and returns accepted job metadata, rate-limit state, or null on fail-silent failure.

getDecision(slotId)

Reads decisions through /v1/decisions/{slot_id}, using WebSocket where configured and polling as fallback.

sendBeacon(beacon)

Records delivery events through /v1/beacons when possible and falls back to wrapper beacon routes when needed.

reportGeneration(jobId, event)

Reports generation lifecycle events so the ad path can be correlated with the AI surface lifecycle without changing model prompts or outputs.

Reference overview

WavebirdClient

Choose hosted defaults or package control

Back to API docs Contact the team

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.