[{"data":1,"prerenderedAt":205},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fapi\u002Fauthentication":3,"docs-section-API":187},{"id":4,"title":5,"body":6,"description":178,"extension":179,"meta":180,"navigation":181,"order":114,"path":182,"section":183,"seo":184,"stem":185,"__hash__":186},"docs\u002Fdocs\u002Fapi\u002Fauthentication.md","Authentication",{"type":7,"value":8,"toc":172},"minimark",[9,13,18,40,47,74,78,86,121,131,135,146,150,160,168],[10,11,12],"p",{},"Every request needs one of your account's API keys.",[14,15,17],"h2",{"id":16},"make-a-key","Make a key",[19,20,21,30,33],"ol",{},[22,23,24,25,29],"li",{},"Open ",[26,27,28],"strong",{},"Dashboard › API",".",[22,31,32],{},"Give the key a name that says where it's used, like \"Website server\".",[22,34,35,36,39],{},"Choose ",[26,37,38],{},"Make key",", then copy the key.",[10,41,42,43,46],{},"The key shows only once. ",[44,45],"brand-name",{}," keeps a fingerprint of it, not the key, so it can't be shown again. If you lose it, revoke it and make another.",[48,49,50,56,62,68],"ul",{},[22,51,52,55],{},[26,53,54],{},"Who can make keys:"," the account's owners and developers. Editors can't, since a key can spend the account's credits.",[22,57,58,61],{},[26,59,60],{},"Which accounts:"," any account with a plan (a website plan or Studio) or with credits.",[22,63,64,67],{},[26,65,66],{},"How many:"," up to 20 at once.",[22,69,70,73],{},[26,71,72],{},"What a key reaches:"," everything in the account: all of its brands, its minutes and its credits.",[14,75,77],{"id":76},"send-it","Send it",[10,79,80,81,85],{},"Send the key in the ",[82,83,84],"code",{},"Authorization"," header of every request:",[87,88,93],"pre",{"className":89,"code":90,"language":91,"meta":92,"style":92},"language-bash shiki shiki-themes github-light github-dark","curl {{base}}\u002Fbrands \\\n  -H \"Authorization: Bearer sbk_your_key_here\"\n","bash","",[82,94,95,112],{"__ignoreMap":92},[96,97,100,104,108],"span",{"class":98,"line":99},"line",1,[96,101,103],{"class":102},"sScJk","curl",[96,105,107],{"class":106},"sZZnC"," {{base}}\u002Fbrands",[96,109,111],{"class":110},"sj4cs"," \\\n",[96,113,115,118],{"class":98,"line":114},2,[96,116,117],{"class":110},"  -H",[96,119,120],{"class":106}," \"Authorization: Bearer sbk_your_key_here\"\n",[10,122,123,124,127,128,29],{},"Keys start with ",[82,125,126],{},"sbk_",". A missing, wrong or revoked key gets a ",[82,129,130],{},"401",[14,132,134],{"id":133},"keep-it-secret","Keep it secret",[48,136,137,140,143],{},[22,138,139],{},"Keep the key on your server, in an environment variable or a secrets store. Never commit it to code.",[22,141,142],{},"Never send it to a browser or put it in an app. The API doesn't answer requests from web pages for this reason.",[22,144,145],{},"Make one key for each place that uses the API. Then you can revoke one without stopping the others.",[14,147,149],{"id":148},"revoke-a-key","Revoke a key",[10,151,152,153,155,156,159],{},"In ",[26,154,28],{},", choose ",[26,157,158],{},"Revoke"," next to the key. It stops working at once. Videos it already made stay.",[10,161,162,163,29],{},"An address that keeps sending wrong keys is blocked for an hour. See ",[164,165,167],"a",{"href":166},"\u002Fdocs\u002Fapi\u002Ferrors-and-limits","Errors and limits",[169,170,171],"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 .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":92,"searchDepth":114,"depth":114,"links":173},[174,175,176,177],{"id":16,"depth":114,"text":17},{"id":76,"depth":114,"text":77},{"id":133,"depth":114,"text":134},{"id":148,"depth":114,"text":149},"Make an API key and send it with every request.","md",{},true,"\u002Fdocs\u002Fapi\u002Fauthentication","API",{"title":5,"description":178},"docs\u002Fapi\u002Fauthentication","hF_YhICAdSyRQ56v9OKewa1SdG_Z4rtn77aRV2pc_tA",[188,191,192,195,198,201,204],{"path":189,"title":190},"\u002Fdocs\u002Fapi","Video API",{"path":182,"title":5},{"path":193,"title":194},"\u002Fdocs\u002Fapi\u002Ftemplates","Templates",{"path":196,"title":197},"\u002Fdocs\u002Fapi\u002Fbrands-and-photos","Brands and photos",{"path":199,"title":200},"\u002Fdocs\u002Fapi\u002Frenders","Renders",{"path":202,"title":203},"\u002Fdocs\u002Fapi\u002Fusage","Usage",{"path":166,"title":167},1793740287638]