curl -X GET "https://api.submagic.co/v1/brand-kits" \
-H "x-api-key: sk-your-api-key-here"
const listBrandKits = async () => {
const response = await fetch("https://api.submagic.co/v1/brand-kits", {
headers: {
"x-api-key": "sk-your-api-key-here",
},
});
return response.json();
};
const { data: brandKits } = await listBrandKits();
import requests
def list_brand_kits():
url = 'https://api.submagic.co/v1/brand-kits'
headers = {
'x-api-key': 'sk-your-api-key-here'
}
response = requests.get(url, headers=headers)
return response.json()
brand_kits = list_brand_kits()['data']
{
"data": [
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name": "Acme",
"isDefault": true
},
{
"id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"name": "Acme Podcast",
"isDefault": false
}
]
}
{
"data": []
}
{
"error": "UNAUTHORIZED",
"message": "Invalid or missing API key"
}
API Reference
List Brand Kits
List the brand kits in your account
GET
/
v1
/
brand-kits
curl -X GET "https://api.submagic.co/v1/brand-kits" \
-H "x-api-key: sk-your-api-key-here"
const listBrandKits = async () => {
const response = await fetch("https://api.submagic.co/v1/brand-kits", {
headers: {
"x-api-key": "sk-your-api-key-here",
},
});
return response.json();
};
const { data: brandKits } = await listBrandKits();
import requests
def list_brand_kits():
url = 'https://api.submagic.co/v1/brand-kits'
headers = {
'x-api-key': 'sk-your-api-key-here'
}
response = requests.get(url, headers=headers)
return response.json()
brand_kits = list_brand_kits()['data']
{
"data": [
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name": "Acme",
"isDefault": true
},
{
"id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"name": "Acme Podcast",
"isDefault": false
}
]
}
{
"data": []
}
{
"error": "UNAUTHORIZED",
"message": "Invalid or missing API key"
}
List Brand Kits
Retrieve the brand kits saved in your Submagic account. Brand kits are made in the Submagic app and hold your brand’s colors, fonts and logos. For a team member, these are the team owner’s brand kits. The kit new projects use by default comes first, then the others, newest first. The list returns at most 50 kits.This endpoint requires authentication and has a rate limit of 1000 requests
per hour. It does not use API credits.
Brand kits are part of some Submagic plans. If your plan does not include
them, the list is empty.
Authentication
Response
Your brand kits
Hide Brand Kit Object
Hide Brand Kit Object
Unique identifier for the brand kit (UUID format). Use it with Get Brand
Kit, or as
brandKitId when you start an
Iris edit.curl -X GET "https://api.submagic.co/v1/brand-kits" \
-H "x-api-key: sk-your-api-key-here"
const listBrandKits = async () => {
const response = await fetch("https://api.submagic.co/v1/brand-kits", {
headers: {
"x-api-key": "sk-your-api-key-here",
},
});
return response.json();
};
const { data: brandKits } = await listBrandKits();
import requests
def list_brand_kits():
url = 'https://api.submagic.co/v1/brand-kits'
headers = {
'x-api-key': 'sk-your-api-key-here'
}
response = requests.get(url, headers=headers)
return response.json()
brand_kits = list_brand_kits()['data']
{
"data": [
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name": "Acme",
"isDefault": true
},
{
"id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"name": "Acme Podcast",
"isDefault": false
}
]
}
{
"data": []
}
{
"error": "UNAUTHORIZED",
"message": "Invalid or missing API key"
}

