# SDK methods

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

Public methods exposed by WavebirdClient.

## 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.