post
https://developer.dacast.com/v2///ads
Set the full ad schedule on a VOD or live channel using a VAST url or a Dacast vod-id creative.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Set the ad schedule for the content with the ads array in this request. The list you send becomes the full configuration - include every slot you want to keep.
There is no update-one-slot call. To drop a single mid-roll while keeping pre-roll, POST again with only the slots that should remain (or GET, edit the list, POST).
Each ad uses either:
- a VAST tag URL in
url(your ad server or a public test tag such as Google IMA sample tags), or - a Dacast VOD as the creative via
vod-id(UUID of another VOD on your account). Do not sendurlfor that slot - list returns a generatedads.dacast.comtag URL.
| Field | Notes |
|---|---|
ad-type | pre-roll, mid-roll, or post-roll |
url | HTTPS VAST tag URL. Mutually exclusive with vod-id for the same slot. |
vod-id | UUID of a VOD used as the ad creative. Mutually exclusive with url. |
timestamp | Required for mid-roll. Integer seconds from content start (for example 120 for two minutes). |
Success returns 200 { "message": "ok" }. Confirm with List ads on a content.
To add slots without rewriting the schedule, use Add ads to content (PUT). To clear every slot, use Remove ads from content (DELETE).
Step-by-step walkthrough: Ads on content.