[{"data":1,"prerenderedAt":502},["ShallowReactive",2],{"page:\u002Fapi-references\u002Fgeneration-attachment\u002Fstart-upload":3},{"id":4,"title":5,"apiPage":6,"body":7,"description":481,"extension":482,"layout":483,"meta":484,"navigation":6,"path":485,"playground":486,"seo":499,"stem":500,"__hash__":501},"docs\u002Fapi-references\u002Fgeneration-attachment\u002Fstart-upload.md","Start Upload",true,{"type":8,"value":9,"toc":473},"minimark",[10,14,19,25,35,51,91,381,385,390,399,403,411,420,424,429,436,469],[11,12,5],"h1",{"id":13},"start-upload",[15,16],"api-endpoint",{"method":17,"url":18},"POST","\u002Fapi\u002Fprojects\u002F:id\u002Fgeneration-attachments\u002Fupload.multipart",[20,21],"api-requirements",{":roles":22,"scope":23,"tier":24},"[\"OWNER\",\"ADMIN\",\"MEMBER\"]","ai:generate","3",[26,27,28,29,34],"p",{},"Starts uploading a reference file for ",[30,31,33],"a",{"href":32},"\u002Fapi-references\u002Ffile\u002Fupload-generate","Generate File",".\nAvailable only in projects of the workspace your API key or connection belongs to, not in projects another workspace has linked to it.",[36,37,38,42,48],"ul",{},[39,40,41],"li",{},"Complete the upload within 24 hours of starting it.",[39,43,44,45,47],{},"Use the attachment in ",[30,46,33],{"href":32}," within 23 hours of starting the upload.",[39,49,50],{},"Attachments you started uploading in the last 24 hours can total up to 10 GB.",[52,53,54],"note",{},[55,56,57,60,76],"ol",{},[39,58,59],{},"Split the file into 100,000,000-byte parts from the start. The last part holds whatever remains.",[39,61,62,63,67,68,71,72,75],{},"Within 30 minutes, upload each part with a PUT to the ",[64,65,66],"code",{},"url"," that has the same ",[64,69,70],{},"partNumber",", and keep the ",[64,73,74],{},"ETag"," header of each response.",[39,77,78,79,83,84,86,87,90],{},"Call ",[30,80,82],{"href":81},"\u002Fapi-references\u002Fgeneration-attachment\u002Fcomplete-upload","Complete Upload"," with every ",[64,85,70],{}," and ",[64,88,89],{},"eTag",".",[92,93,95,100,162,266,307],"api-example",{"method":17,"url":18,"status":94},"201 Created",[96,97,99],"h2",{"id":98},"example","Example",[101,102,107],"pre",{"className":103,"code":104,"language":105,"meta":106,"style":106},"language-bash shiki shiki-themes ayu-light ayu-light ayu-dark","curl -X POST 'https:\u002F\u002Fapi.youvico.com\u002Fapi\u002Fprojects\u002Fbdbff5de-96d7-468f-9db0-85fe28bd6b62\u002Fgeneration-attachments\u002Fupload.multipart' \\\n  -H 'Authorization: Bearer YOUR_API_KEY' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{ \"name\": \"reference.png\", \"size\": 2400000 }'\n","bash","",[64,108,109,132,143,153],{"__ignoreMap":106},[110,111,114,118,122,126,129],"span",{"class":112,"line":113},"line",1,[110,115,117],{"class":116},"s6MYo","curl",[110,119,121],{"class":120},"sTJUr"," -X",[110,123,125],{"class":124},"sHwJV"," POST",[110,127,128],{"class":124}," 'https:\u002F\u002Fapi.youvico.com\u002Fapi\u002Fprojects\u002Fbdbff5de-96d7-468f-9db0-85fe28bd6b62\u002Fgeneration-attachments\u002Fupload.multipart'",[110,130,131],{"class":120}," \\\n",[110,133,135,138,141],{"class":112,"line":134},2,[110,136,137],{"class":120},"  -H",[110,139,140],{"class":124}," 'Authorization: Bearer YOUR_API_KEY'",[110,142,131],{"class":120},[110,144,146,148,151],{"class":112,"line":145},3,[110,147,137],{"class":120},[110,149,150],{"class":124}," 'Content-Type: application\u002Fjson'",[110,152,131],{"class":120},[110,154,156,159],{"class":112,"line":155},4,[110,157,158],{"class":120},"  -d",[110,160,161],{"class":124}," '{ \"name\": \"reference.png\", \"size\": 2400000 }'\n",[101,163,167],{"className":164,"code":165,"language":166,"meta":106,"style":106},"language-json shiki shiki-themes ayu-light ayu-light ayu-dark","{\n  \"data\": {\n    \"id\": \"GA1234567890ABCD\",\n    \"parts\": [\n      {\n        \"partNumber\": 1,\n        \"url\": \"https:\u002F\u002Ffiles.youvico.com\u002Fupload\u002FeyJhbGciOiJFZERTQSIsImtpZCI6...\"\n      }\n    ]\n  }\n}\n","json",[64,168,169,175,188,201,211,217,231,242,248,254,260],{"__ignoreMap":106},[110,170,171],{"class":112,"line":113},[110,172,174],{"class":173},"snvv_","{\n",[110,176,177,181,185],{"class":112,"line":134},[110,178,180],{"class":179},"soLcz","  \"data\"",[110,182,184],{"class":183},"sgRSP",":",[110,186,187],{"class":173}," {\n",[110,189,190,193,195,198],{"class":112,"line":145},[110,191,192],{"class":179},"    \"id\"",[110,194,184],{"class":183},[110,196,197],{"class":124}," \"GA1234567890ABCD\"",[110,199,200],{"class":183},",\n",[110,202,203,206,208],{"class":112,"line":155},[110,204,205],{"class":179},"    \"parts\"",[110,207,184],{"class":183},[110,209,210],{"class":173}," [\n",[110,212,214],{"class":112,"line":213},5,[110,215,216],{"class":173},"      {\n",[110,218,220,223,225,229],{"class":112,"line":219},6,[110,221,222],{"class":179},"        \"partNumber\"",[110,224,184],{"class":183},[110,226,228],{"class":227},"ss_QQ"," 1",[110,230,200],{"class":183},[110,232,234,237,239],{"class":112,"line":233},7,[110,235,236],{"class":179},"        \"url\"",[110,238,184],{"class":183},[110,240,241],{"class":124}," \"https:\u002F\u002Ffiles.youvico.com\u002Fupload\u002FeyJhbGciOiJFZERTQSIsImtpZCI6...\"\n",[110,243,245],{"class":112,"line":244},8,[110,246,247],{"class":173},"      }\n",[110,249,251],{"class":112,"line":250},9,[110,252,253],{"class":173},"    ]\n",[110,255,257],{"class":112,"line":256},10,[110,258,259],{"class":173},"  }\n",[110,261,263],{"class":112,"line":262},11,[110,264,265],{"class":173},"}\n",[267,268,269],"template",{"v-slot:request":106},[101,270,271],{"className":103,"code":104,"language":105,"meta":106,"style":106},[64,272,273,285,293,301],{"__ignoreMap":106},[110,274,275,277,279,281,283],{"class":112,"line":113},[110,276,117],{"class":116},[110,278,121],{"class":120},[110,280,125],{"class":124},[110,282,128],{"class":124},[110,284,131],{"class":120},[110,286,287,289,291],{"class":112,"line":134},[110,288,137],{"class":120},[110,290,140],{"class":124},[110,292,131],{"class":120},[110,294,295,297,299],{"class":112,"line":145},[110,296,137],{"class":120},[110,298,150],{"class":124},[110,300,131],{"class":120},[110,302,303,305],{"class":112,"line":155},[110,304,158],{"class":120},[110,306,161],{"class":124},[267,308,309],{"v-slot:response":106},[101,310,311],{"className":164,"code":165,"language":166,"meta":106,"style":106},[64,312,313,317,325,335,343,347,357,365,369,373,377],{"__ignoreMap":106},[110,314,315],{"class":112,"line":113},[110,316,174],{"class":173},[110,318,319,321,323],{"class":112,"line":134},[110,320,180],{"class":179},[110,322,184],{"class":183},[110,324,187],{"class":173},[110,326,327,329,331,333],{"class":112,"line":145},[110,328,192],{"class":179},[110,330,184],{"class":183},[110,332,197],{"class":124},[110,334,200],{"class":183},[110,336,337,339,341],{"class":112,"line":155},[110,338,205],{"class":179},[110,340,184],{"class":183},[110,342,210],{"class":173},[110,344,345],{"class":112,"line":213},[110,346,216],{"class":173},[110,348,349,351,353,355],{"class":112,"line":219},[110,350,222],{"class":179},[110,352,184],{"class":183},[110,354,228],{"class":227},[110,356,200],{"class":183},[110,358,359,361,363],{"class":112,"line":233},[110,360,236],{"class":179},[110,362,184],{"class":183},[110,364,241],{"class":124},[110,366,367],{"class":112,"line":244},[110,368,247],{"class":173},[110,370,371],{"class":112,"line":250},[110,372,253],{"class":173},[110,374,375],{"class":112,"line":256},[110,376,259],{"class":173},[110,378,379],{"class":112,"line":262},[110,380,265],{"class":173},[96,382,384],{"id":383},"request","Request",[386,387,389],"h3",{"id":388},"path","Path",[391,392,396],"param-field",{"name":393,"type":394,":required":395},"id","string","true",[26,397,398],{},"Project ID",[386,400,402],{"id":401},"body","Body",[391,404,408],{"name":405,"type":394,"example":406,":required":395,"constraints":407},"name","reference.png","1-255 characters",[26,409,410],{},"Attachment file name",[391,412,417],{"name":413,"type":414,"example":415,":required":395,"constraints":416},"size","number","2400000","Integer, 1-1000000000",[26,418,419],{},"Attachment size in bytes",[96,421,423],{"id":422},"response","Response",[26,425,426,427,90],{},"Returns ",[64,428,94],{},[391,430,433],{"name":431,"type":432},"data","object",[26,434,435],{},"Upload session",[437,438,439,446,453],"param-children",{},[391,440,443],{"name":441,"type":394,"example":442,":indent":395},"data.id","GA1234567890ABCD",[26,444,445],{},"Created generation attachment ID",[391,447,450],{"name":448,"type":449,":indent":395},"data.parts","array",[26,451,452],{},"Upload parts",[437,454,455,462],{},[391,456,459],{"name":457,"type":414,"example":458,":indent":395},"data.parts[].partNumber","1",[26,460,461],{},"Part number",[391,463,466],{"name":464,"type":394,"example":465,":indent":395},"data.parts[].url","https:\u002F\u002Ffiles.youvico.com\u002Fupload\u002FeyJhbGciOiJFZERTQSIsImtpZCI6...",[26,467,468],{},"Part upload URL",[470,471,472],"style",{},"html pre.shiki code .s6MYo, html code.shiki .s6MYo{--shiki-light:#22A4E6;--shiki-default:#22A4E6;--shiki-dark:#59C2FF}html pre.shiki code .sTJUr, html code.shiki .sTJUr{--shiki-light:#4CBF99;--shiki-default:#4CBF99;--shiki-dark:#95E6CB}html pre.shiki code .sHwJV, html code.shiki .sHwJV{--shiki-light:#86B300;--shiki-default:#86B300;--shiki-dark:#AAD94C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}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);}html pre.shiki code .snvv_, html code.shiki .snvv_{--shiki-light:#5C6166;--shiki-default:#5C6166;--shiki-dark:#BFBDB6}html pre.shiki code .soLcz, html code.shiki .soLcz{--shiki-light:#55B4D4;--shiki-default:#55B4D4;--shiki-dark:#39BAE6}html pre.shiki code .sgRSP, html code.shiki .sgRSP{--shiki-light:#5C6166B3;--shiki-default:#5C6166B3;--shiki-dark:#BFBDB6B3}html pre.shiki code .ss_QQ, html code.shiki .ss_QQ{--shiki-light:#A37ACC;--shiki-default:#A37ACC;--shiki-dark:#D2A6FF}",{"title":106,"searchDepth":155,"depth":155,"links":474},[475,476,480],{"id":98,"depth":134,"text":99},{"id":383,"depth":134,"text":384,"children":477},[478,479],{"id":388,"depth":145,"text":389},{"id":401,"depth":145,"text":402},{"id":422,"depth":134,"text":423},"Start uploading a reference file for Generate File. Complete it within 24 hours and use it within 23; uploads in any 24 hours can total 10 GB.","md",null,{},"\u002Fapi-references\u002Fgeneration-attachment\u002Fstart-upload",{"method":17,"path":18,"params":487,"body":490,"fields":491},[488],{"name":393,"example":489,"type":394,"required":6,"constraints":106,"description":398},"bdbff5de-96d7-468f-9db0-85fe28bd6b62","{\n  \"name\": \"reference.png\",\n  \"size\": 2400000\n}",[492,496],{"key":405,"type":394,"required":6,"constraints":407,"description":410,"values":493,"array":494,"children":495},[],false,[],{"key":413,"type":414,"required":6,"constraints":416,"description":419,"values":497,"array":494,"children":498},[],[],{"title":5,"description":481},"api-references\u002Fgeneration-attachment\u002Fstart-upload","h8pf_dwEn69bFANlNCSflbdtN-_BcDW7FGMZpAmd-HI",1792305902863]