[{"data":1,"prerenderedAt":414},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fapi\u002Fbrands-and-photos":3,"docs-section-API":394},{"id":4,"title":5,"body":6,"description":385,"extension":386,"meta":387,"navigation":388,"order":127,"path":389,"section":390,"seo":391,"stem":392,"__hash__":393},"docs\u002Fdocs\u002Fapi\u002Fbrands-and-photos.md","Brands and photos",{"type":7,"value":8,"toc":378},"minimark",[9,14,23,66,170,177,181,188,193,200,253,315,324,340,344,367,374],[10,11,13],"h2",{"id":12},"brands","Brands",[15,16,17,18,22],"p",{},"A brand is a business's logo, web address and colors, plus its photos and videos. Each website in your account has its own brand, and you can make brands for businesses without a website in ",[19,20,21],"strong",{},"Dashboard › Studio",".",[24,25,30],"pre",{"className":26,"code":27,"language":28,"meta":29,"style":29},"language-bash shiki shiki-themes github-light github-dark","curl {{base}}\u002Fbrands \\\n  -H \"Authorization: Bearer $API_KEY\"\n","bash","",[31,32,33,50],"code",{"__ignoreMap":29},[34,35,38,42,46],"span",{"class":36,"line":37},"line",1,[34,39,41],{"class":40},"sScJk","curl",[34,43,45],{"class":44},"sZZnC"," {{base}}\u002Fbrands",[34,47,49],{"class":48},"sj4cs"," \\\n",[34,51,53,56,59,63],{"class":36,"line":52},2,[34,54,55],{"class":48},"  -H",[34,57,58],{"class":44}," \"Authorization: Bearer ",[34,60,62],{"class":61},"sVt8B","$API_KEY",[34,64,65],{"class":44},"\"\n",[24,67,71],{"className":68,"code":69,"language":70,"meta":29,"style":29},"language-json shiki shiki-themes github-light github-dark","{\n  \"brands\": [\n    { \"id\": \"cm9x2brand0001\", \"name\": \"Fernbrook Bakery\", \"website\": true },\n    { \"id\": \"cm9x2brand0002\", \"name\": \"Saturday pop-up\", \"website\": false }\n  ]\n}\n","json",[31,72,73,78,86,125,158,164],{"__ignoreMap":29},[34,74,75],{"class":36,"line":37},[34,76,77],{"class":61},"{\n",[34,79,80,83],{"class":36,"line":52},[34,81,82],{"class":48},"  \"brands\"",[34,84,85],{"class":61},": [\n",[34,87,89,92,95,98,101,104,107,109,112,114,117,119,122],{"class":36,"line":88},3,[34,90,91],{"class":61},"    { ",[34,93,94],{"class":48},"\"id\"",[34,96,97],{"class":61},": ",[34,99,100],{"class":44},"\"cm9x2brand0001\"",[34,102,103],{"class":61},", ",[34,105,106],{"class":48},"\"name\"",[34,108,97],{"class":61},[34,110,111],{"class":44},"\"Fernbrook Bakery\"",[34,113,103],{"class":61},[34,115,116],{"class":48},"\"website\"",[34,118,97],{"class":61},[34,120,121],{"class":48},"true",[34,123,124],{"class":61}," },\n",[34,126,128,130,132,134,137,139,141,143,146,148,150,152,155],{"class":36,"line":127},4,[34,129,91],{"class":61},[34,131,94],{"class":48},[34,133,97],{"class":61},[34,135,136],{"class":44},"\"cm9x2brand0002\"",[34,138,103],{"class":61},[34,140,106],{"class":48},[34,142,97],{"class":61},[34,144,145],{"class":44},"\"Saturday pop-up\"",[34,147,103],{"class":61},[34,149,116],{"class":48},[34,151,97],{"class":61},[34,153,154],{"class":48},"false",[34,156,157],{"class":61}," }\n",[34,159,161],{"class":36,"line":160},5,[34,162,163],{"class":61},"  ]\n",[34,165,167],{"class":36,"line":166},6,[34,168,169],{"class":61},"}\n",[15,171,172,173,176],{},"Every render names its brand by ",[31,174,175],{},"id",". The brand's logo, web address and colors fill those parts of the video.",[10,178,180],{"id":179},"photos","Photos",[15,182,183,184,187],{},"A template's image names take one of the brand's photos, by its ",[31,185,186],{},"name",". Upload a photo first, then use its name in a render.",[189,190,192],"h3",{"id":191},"upload-a-photo","Upload a photo",[15,194,195,196,199],{},"Send the photo itself as the request body: JPEG, PNG or WebP, up to 4 MB. ",[31,197,198],{},"X-File-Name"," is optional and makes the stored name readable.",[24,201,203],{"className":26,"code":202,"language":28,"meta":29,"style":29},"curl {{base}}\u002Fbrands\u002Fcm9x2brand0001\u002Fphotos \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: image\u002Fjpeg\" \\\n  -H \"X-File-Name: fresh-loaves.jpg\" \\\n  --data-binary @fresh-loaves.jpg\n",[31,204,205,214,227,236,245],{"__ignoreMap":29},[34,206,207,209,212],{"class":36,"line":37},[34,208,41],{"class":40},[34,210,211],{"class":44}," {{base}}\u002Fbrands\u002Fcm9x2brand0001\u002Fphotos",[34,213,49],{"class":48},[34,215,216,218,220,222,225],{"class":36,"line":52},[34,217,55],{"class":48},[34,219,58],{"class":44},[34,221,62],{"class":61},[34,223,224],{"class":44},"\"",[34,226,49],{"class":48},[34,228,229,231,234],{"class":36,"line":88},[34,230,55],{"class":48},[34,232,233],{"class":44}," \"Content-Type: image\u002Fjpeg\"",[34,235,49],{"class":48},[34,237,238,240,243],{"class":36,"line":127},[34,239,55],{"class":48},[34,241,242],{"class":44}," \"X-File-Name: fresh-loaves.jpg\"",[34,244,49],{"class":48},[34,246,247,250],{"class":36,"line":160},[34,248,249],{"class":48},"  --data-binary",[34,251,252],{"class":44}," @fresh-loaves.jpg\n",[24,254,256],{"className":68,"code":255,"language":70,"meta":29,"style":29},"{\n  \"photo\": {\n    \"name\": \"fresh-loaves-3fa9c2.jpg\",\n    \"url\": \"{{site}}\u002Fsite-files\u002F…\u002Ffresh-loaves-3fa9c2.jpg\",\n    \"createdAt\": \"2026-10-29T18:00:00.000Z\"\n  }\n}\n",[31,257,258,262,270,283,295,305,310],{"__ignoreMap":29},[34,259,260],{"class":36,"line":37},[34,261,77],{"class":61},[34,263,264,267],{"class":36,"line":52},[34,265,266],{"class":48},"  \"photo\"",[34,268,269],{"class":61},": {\n",[34,271,272,275,277,280],{"class":36,"line":88},[34,273,274],{"class":48},"    \"name\"",[34,276,97],{"class":61},[34,278,279],{"class":44},"\"fresh-loaves-3fa9c2.jpg\"",[34,281,282],{"class":61},",\n",[34,284,285,288,290,293],{"class":36,"line":127},[34,286,287],{"class":48},"    \"url\"",[34,289,97],{"class":61},[34,291,292],{"class":44},"\"{{site}}\u002Fsite-files\u002F…\u002Ffresh-loaves-3fa9c2.jpg\"",[34,294,282],{"class":61},[34,296,297,300,302],{"class":36,"line":160},[34,298,299],{"class":48},"    \"createdAt\"",[34,301,97],{"class":61},[34,303,304],{"class":44},"\"2026-10-29T18:00:00.000Z\"\n",[34,306,307],{"class":36,"line":166},[34,308,309],{"class":61},"  }\n",[34,311,313],{"class":36,"line":312},7,[34,314,169],{"class":61},[15,316,317,318,320,321,22],{},"Use ",[31,319,186],{}," in a render: ",[31,322,323],{},"\"modifications\": { \"photo_1\": \"fresh-loaves-3fa9c2.jpg\" }",[325,326,327,331,337],"ul",{},[328,329,330],"li",{},"Size it for video first: 1920 pixels on the longer side is plenty.",[328,332,333,334,22],{},"What a file really is comes from its contents, not its name or type. Anything other than a JPEG, PNG or WebP gets a ",[31,335,336],{},"415",[328,338,339],{},"A website's photos are its site's own uploads, the same ones its editor shows.",[189,341,343],{"id":342},"list-photos","List photos",[24,345,347],{"className":26,"code":346,"language":28,"meta":29,"style":29},"curl {{base}}\u002Fbrands\u002Fcm9x2brand0001\u002Fphotos \\\n  -H \"Authorization: Bearer $API_KEY\"\n",[31,348,349,357],{"__ignoreMap":29},[34,350,351,353,355],{"class":36,"line":37},[34,352,41],{"class":40},[34,354,211],{"class":44},[34,356,49],{"class":48},[34,358,359,361,363,365],{"class":36,"line":52},[34,360,55],{"class":48},[34,362,58],{"class":44},[34,364,62],{"class":61},[34,366,65],{"class":44},[15,368,369,370,373],{},"You get ",[31,371,372],{},"{ \"photos\": [ … ] }",", newest first, up to 300.",[375,376,377],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":29,"searchDepth":52,"depth":52,"links":379},[380,381],{"id":12,"depth":52,"text":13},{"id":179,"depth":52,"text":180,"children":382},[383,384],{"id":191,"depth":88,"text":192},{"id":342,"depth":88,"text":343},"Every video is made for one of your brands, from its logo, colors and photos.","md",{},true,"\u002Fdocs\u002Fapi\u002Fbrands-and-photos","API",{"title":5,"description":385},"docs\u002Fapi\u002Fbrands-and-photos","YAevAjjZdr4zeKPIAP3tc29wPRU2Iv2AECB4ivxKctg",[395,398,401,404,405,408,411],{"path":396,"title":397},"\u002Fdocs\u002Fapi","Video API",{"path":399,"title":400},"\u002Fdocs\u002Fapi\u002Fauthentication","Authentication",{"path":402,"title":403},"\u002Fdocs\u002Fapi\u002Ftemplates","Templates",{"path":389,"title":5},{"path":406,"title":407},"\u002Fdocs\u002Fapi\u002Frenders","Renders",{"path":409,"title":410},"\u002Fdocs\u002Fapi\u002Fusage","Usage",{"path":412,"title":413},"\u002Fdocs\u002Fapi\u002Ferrors-and-limits","Errors and limits",1793740287675]