Upload Brand Assets
curl --request POST \
--url https://api.myustadia.com/api/v1/presets/{preset_id}/brand-assets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"logo_url": "<string>",
"logo_base64": "<string>",
"logo_content_type": "image/png",
"brand_pdf_url": "<string>",
"primary_color": "<string>",
"secondary_color": "<string>",
"font_family": "<string>",
"tagline": "<string>"
}
'import requests
url = "https://api.myustadia.com/api/v1/presets/{preset_id}/brand-assets"
payload = {
"logo_url": "<string>",
"logo_base64": "<string>",
"logo_content_type": "image/png",
"brand_pdf_url": "<string>",
"primary_color": "<string>",
"secondary_color": "<string>",
"font_family": "<string>",
"tagline": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
logo_url: '<string>',
logo_base64: '<string>',
logo_content_type: 'image/png',
brand_pdf_url: '<string>',
primary_color: '<string>',
secondary_color: '<string>',
font_family: '<string>',
tagline: '<string>'
})
};
fetch('https://api.myustadia.com/api/v1/presets/{preset_id}/brand-assets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.myustadia.com/api/v1/presets/{preset_id}/brand-assets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'logo_url' => '<string>',
'logo_base64' => '<string>',
'logo_content_type' => 'image/png',
'brand_pdf_url' => '<string>',
'primary_color' => '<string>',
'secondary_color' => '<string>',
'font_family' => '<string>',
'tagline' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.myustadia.com/api/v1/presets/{preset_id}/brand-assets"
payload := strings.NewReader("{\n \"logo_url\": \"<string>\",\n \"logo_base64\": \"<string>\",\n \"logo_content_type\": \"image/png\",\n \"brand_pdf_url\": \"<string>\",\n \"primary_color\": \"<string>\",\n \"secondary_color\": \"<string>\",\n \"font_family\": \"<string>\",\n \"tagline\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.myustadia.com/api/v1/presets/{preset_id}/brand-assets")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"logo_url\": \"<string>\",\n \"logo_base64\": \"<string>\",\n \"logo_content_type\": \"image/png\",\n \"brand_pdf_url\": \"<string>\",\n \"primary_color\": \"<string>\",\n \"secondary_color\": \"<string>\",\n \"font_family\": \"<string>\",\n \"tagline\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.myustadia.com/api/v1/presets/{preset_id}/brand-assets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"logo_url\": \"<string>\",\n \"logo_base64\": \"<string>\",\n \"logo_content_type\": \"image/png\",\n \"brand_pdf_url\": \"<string>\",\n \"primary_color\": \"<string>\",\n \"secondary_color\": \"<string>\",\n \"font_family\": \"<string>\",\n \"tagline\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}B2B Preset setup
Upload Brand Assets
Upload or patch the raw brand inputs for a preset: logo (file or URL), colors, font, tagline, brand PDF. Only the fields you supply are patched; a re-upload merges into what is already stored.
logo_base64 (a logo FILE) wins over logo_url and is quality-gated before storage. 400 error codes:
invalid_base64: logo_base64 is not valid base64invalid_image: the decoded file is not a readable imagelogo_too_small: longest side under 64 px (server default); too small to composite sharply onto slideslogo_too_large: base64 payload over ~7 MB, or raster over 8192 px on the longest sideinvalid_color_hex: primary_color / secondary_color is not a hex value like #005f99
Response: {uploaded, preset_id, logo_url} (logo_url is a signed URL).
When a logo file was uploaded, the response also carries logo_px
([width, height]) and logo_low_res (true when the longest side is under
200 px: accepted, but flagged as a quality warning worth surfacing).
POST
/
api
/
v1
/
presets
/
{preset_id}
/
brand-assets
Upload Brand Assets
curl --request POST \
--url https://api.myustadia.com/api/v1/presets/{preset_id}/brand-assets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"logo_url": "<string>",
"logo_base64": "<string>",
"logo_content_type": "image/png",
"brand_pdf_url": "<string>",
"primary_color": "<string>",
"secondary_color": "<string>",
"font_family": "<string>",
"tagline": "<string>"
}
'import requests
url = "https://api.myustadia.com/api/v1/presets/{preset_id}/brand-assets"
payload = {
"logo_url": "<string>",
"logo_base64": "<string>",
"logo_content_type": "image/png",
"brand_pdf_url": "<string>",
"primary_color": "<string>",
"secondary_color": "<string>",
"font_family": "<string>",
"tagline": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
logo_url: '<string>',
logo_base64: '<string>',
logo_content_type: 'image/png',
brand_pdf_url: '<string>',
primary_color: '<string>',
secondary_color: '<string>',
font_family: '<string>',
tagline: '<string>'
})
};
fetch('https://api.myustadia.com/api/v1/presets/{preset_id}/brand-assets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.myustadia.com/api/v1/presets/{preset_id}/brand-assets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'logo_url' => '<string>',
'logo_base64' => '<string>',
'logo_content_type' => 'image/png',
'brand_pdf_url' => '<string>',
'primary_color' => '<string>',
'secondary_color' => '<string>',
'font_family' => '<string>',
'tagline' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.myustadia.com/api/v1/presets/{preset_id}/brand-assets"
payload := strings.NewReader("{\n \"logo_url\": \"<string>\",\n \"logo_base64\": \"<string>\",\n \"logo_content_type\": \"image/png\",\n \"brand_pdf_url\": \"<string>\",\n \"primary_color\": \"<string>\",\n \"secondary_color\": \"<string>\",\n \"font_family\": \"<string>\",\n \"tagline\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.myustadia.com/api/v1/presets/{preset_id}/brand-assets")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"logo_url\": \"<string>\",\n \"logo_base64\": \"<string>\",\n \"logo_content_type\": \"image/png\",\n \"brand_pdf_url\": \"<string>\",\n \"primary_color\": \"<string>\",\n \"secondary_color\": \"<string>\",\n \"font_family\": \"<string>\",\n \"tagline\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.myustadia.com/api/v1/presets/{preset_id}/brand-assets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"logo_url\": \"<string>\",\n \"logo_base64\": \"<string>\",\n \"logo_content_type\": \"image/png\",\n \"brand_pdf_url\": \"<string>\",\n \"primary_color\": \"<string>\",\n \"secondary_color\": \"<string>\",\n \"font_family\": \"<string>\",\n \"tagline\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
application/json
Response
Successful Response
⌘I