wavebird logo
GET/v1/render.js

Hosted renderer script

Load this script in the customer frontend for the default Server API render path. It exposes window.wavebird.renderPlacement, clearPlacement, startTurn, and withTurn.

Publishable key flowNo authorization headerSandbox this

Request parameters

NameTypeRequiredDescription

Returns

NameTypeDescription
window.wavebird.renderPlacement(options)functionRenders a decision or placement into a target element using placement.render.frame_url.
window.wavebird.withTurn(target, work)functionStarts the placement request, runs the app work, and preserves required viewability timing before cleanup.

Request example

GET /v1/render.js

get-renderer.shbash
1curl "https://api.wavebird.ai/v1/render.js" \2  -H "Accept: application/javascript"

Response example

Response

response.jsonjson
1window.wavebird.renderPlacement({ target: "#wavebird-slot", decision });

Errors

not_found404

Renderer script route is unavailable.

Related

API v1 overview →Testing in sandbox →Errors →

Need rollout review?

Start with the Server API. Use contact only when you need rollout review, enterprise coordination, or non-standard integration help.

Contact the team