Re-apply a video spec preset to all publisher sites using it

Reference

POST https://YOUR-NETWORK-DOMAIN/rest-api/video-requirements/presets/{presetId}/apply-to-sites.do

Pushes the preset's current values to every live site whose requirements were filled from it — what video-requirements/apply-preset does for one site, so a spec edited here reaches the sites that use it. Each site's own changes are replaced; its switch is not changed. Each site goes through the checks one apply-preset would: the SITE_VIDEO_CREATIVE_REQUIREMENTS permission (enabled) and UPDATE access to the site. A site that fails them is left as it is and listed in notUpdated with the reason (also in ignoredFields / ignoredFieldReasons as site:<id>); updated counts the sites changed, sites lists them (the first 100, with total and more). The ad servers pick the change up on their next reload, within seconds. Requires the VIDEO_REQUIREMENT_PRESETS admin permission (Admin → Creatives & tags → Video requirement presets).

Path Params

presetId string required

Preset id

hulu

Responses

200

{updated, sites: [{id, name}], total, more, notUpdated: [{id, name, reason}]}

400

Bad request — invalid or missing parameters

401

Authentication error

403

Insufficient permissions, naming the missing one; also when no site could be updated for lack of rights

404

No preset with this id

Language

cURL Request

curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/video-requirements/presets/hulu/apply-to-sites.do' \
  --header 'X-Api-Key: YOUR_API_KEY'

Python Request

import requests

response = requests.request("POST", "https://YOUR-NETWORK-DOMAIN/rest-api/video-requirements/presets/hulu/apply-to-sites.do", headers={"X-Api-Key": "YOUR_API_KEY"})
print(response.json())

Node Request

const response = await fetch('https://YOUR-NETWORK-DOMAIN/rest-api/video-requirements/presets/hulu/apply-to-sites.do', {
  method: 'POST',
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
});

console.log(await response.json());

Java Request

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://YOUR-NETWORK-DOMAIN/rest-api/video-requirements/presets/hulu/apply-to-sites.do"))
    .header("X-Api-Key", "YOUR_API_KEY")
    .method("POST", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

C# Request

using var client = new HttpClient();

var request = new HttpRequestMessage(new HttpMethod("POST"), "https://YOUR-NETWORK-DOMAIN/rest-api/video-requirements/presets/hulu/apply-to-sites.do");
request.Headers.Add("X-Api-Key", "YOUR_API_KEY");

var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Go Request

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("POST", "https://YOUR-NETWORK-DOMAIN/rest-api/video-requirements/presets/hulu/apply-to-sites.do", nil)
	req.Header.Set("X-Api-Key", "YOUR_API_KEY")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	out, _ := io.ReadAll(res.Body)
	fmt.Println(string(out))
}

PHP Request

<?php
$ch = curl_init("https://YOUR-NETWORK-DOMAIN/rest-api/video-requirements/presets/hulu/apply-to-sites.do");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY"]);

echo curl_exec($ch);
curl_close($ch);

Ruby Request

require 'net/http'
require 'json'

uri = URI("https://YOUR-NETWORK-DOMAIN/rest-api/video-requirements/presets/hulu/apply-to-sites.do")
request = Net::HTTP::Post.new(uri)
request['X-Api-Key'] = 'YOUR_API_KEY'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
puts response.body