Creatives

Host-voiced ads for a podcast

List creatives for a podcast

Returns a cursor-paginated page of the podcast's host-voiced creatives, ordered by id. Each item carries its current generation status (pending, ready, or failed). Requires read access to the podcast's network.

Create a creative and start generating its host-voiced audio

Resolves the ad copy server-side (from the supplied ad_copy, otherwise the referenced campaign variant) and the voice (voice_id, defaulting to the podcast's primary voice), creates a pending creative, and kicks off synthesis asynchronously. Returns 202 with a Location header; poll that creative for ready/failed or subscribe to the creative.ready/creative.failed webhook. Requires administrator access to the podcast's network.

Get a single creative

Fetches one creative, the result resource for host-voiced generation. Poll this while status is pending; on success it becomes ready with an audio_url, on failure it becomes failed with a client-safe failure_reason. Requires read access to the podcast's network.

Regenerate a creative's host-voiced audio (e.g. after a failed generation)

Re-runs generation for an existing creative, reusing its already-resolved ad copy and voice; useful to retry a failed creative or refresh a ready one. Like create, synthesis runs asynchronously and returns 202 with a Location header — poll the creative for ready/failed. Requires administrator access to the podcast's network.