Update an upstream macro preset

Changes only the fields in the body and keeps the others; macros, when sent, replace the whole map.

Reference

POST https://YOUR-NETWORK-DOMAIN/rest-api/upstream-macro-presets/{presetId}.do

Changes only the fields in the body and keeps the others; macros, when sent, replace the whole map. {"active": false} takes the preset off the list placements pick from, while placements that already use it keep their tags. A built-in preset keeps its code. Tags generated after the change carry the new macros; tags already handed to an upstream do not change. Requires the UPSTREAM_MACRO_PRESETS admin permission (Admin → Creatives & tags → Upstream macro presets).

Path Params

presetId string required

Preset id or code

SPRINGSERVE

Body

A JSON body. An example, built from the field definitions:

{
  "code": "ACME_SSAI",
  "name": "Acme SSAI",
  "source": "https://docs.acme.tv/ssai/macros",
  "asOf": "2026-11-04"
}

Responses

200

{preset, ignoredFields}

400

Invalid body, each problem named in errors by field

401

Authentication error

403

Insufficient permissions, naming the missing one

404

No preset with this id or code

409

Another preset already has this code

Language

cURL Request

curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/upstream-macro-presets/SPRINGSERVE.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "code": "ACME_SSAI",
  "name": "Acme SSAI",
  "source": "https://docs.acme.tv/ssai/macros",
  "asOf": "2026-11-04"
}'

Python Request

import requests

response = requests.request("POST", "https://YOUR-NETWORK-DOMAIN/rest-api/upstream-macro-presets/SPRINGSERVE.do", headers={"X-Api-Key": "YOUR_API_KEY"}, json={
    "code": "ACME_SSAI",
    "name": "Acme SSAI",
    "source": "https://docs.acme.tv/ssai/macros",
    "asOf": "2026-11-04"
})
print(response.json())

Node Request

const response = await fetch('https://YOUR-NETWORK-DOMAIN/rest-api/upstream-macro-presets/SPRINGSERVE.do', {
  method: 'POST',
  headers: { 'X-Api-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "code": "ACME_SSAI",
    "name": "Acme SSAI",
    "source": "https://docs.acme.tv/ssai/macros",
    "asOf": "2026-11-04"
  }),
});

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

Java Request

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://YOUR-NETWORK-DOMAIN/rest-api/upstream-macro-presets/SPRINGSERVE.do"))
    .header("X-Api-Key", "YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"code\":\"ACME_SSAI\",\"name\":\"Acme SSAI\",\"source\":\"https://docs.acme.tv/ssai/macros\",\"asOf\":\"2026-11-04\"}"))
    .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/upstream-macro-presets/SPRINGSERVE.do");
request.Headers.Add("X-Api-Key", "YOUR_API_KEY");
request.Content = new StringContent("{\"code\":\"ACME_SSAI\",\"name\":\"Acme SSAI\",\"source\":\"https://docs.acme.tv/ssai/macros\",\"asOf\":\"2026-11-04\"}", Encoding.UTF8, "application/json");

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

Go Request

package main

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

func main() {
	req, _ := http.NewRequest("POST", "https://YOUR-NETWORK-DOMAIN/rest-api/upstream-macro-presets/SPRINGSERVE.do", strings.NewReader(`{"code":"ACME_SSAI","name":"Acme SSAI","source":"https://docs.acme.tv/ssai/macros","asOf":"2026-11-04"}`))
	req.Header.Set("X-Api-Key", "YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	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/upstream-macro-presets/SPRINGSERVE.do");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY", "Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"code":"ACME_SSAI","name":"Acme SSAI","source":"https://docs.acme.tv/ssai/macros","asOf":"2026-11-04"}');

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

Ruby Request

require 'net/http'
require 'json'

uri = URI("https://YOUR-NETWORK-DOMAIN/rest-api/upstream-macro-presets/SPRINGSERVE.do")
request = Net::HTTP::Post.new(uri)
request['X-Api-Key'] = 'YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = "{\"code\":\"ACME_SSAI\",\"name\":\"Acme SSAI\",\"source\":\"https://docs.acme.tv/ssai/macros\",\"asOf\":\"2026-11-04\"}"

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