[{"data":1,"prerenderedAt":606},["ShallowReactive",2],{"page:\u002Fapi-references\u002Ffile\u002Fupload-multipart":3},{"id":4,"title":5,"apiPage":6,"body":7,"description":585,"extension":586,"layout":587,"meta":588,"navigation":6,"path":589,"playground":590,"seo":603,"stem":604,"__hash__":605},"docs\u002Fapi-references\u002Ffile\u002Fupload-multipart.md","Start Multipart Upload",true,{"type":8,"value":9,"toc":577},"minimark",[10,14,19,26,30,72,485,489,494,503,507,515,524,528,533,540,573],[11,12,5],"h1",{"id":13},"start-multipart-upload",[15,16],"api-endpoint",{"method":17,"url":18},"POST","\u002Fapi\u002Fprojects\u002F:id\u002Ffiles\u002Fupload.multipart",[20,21],"api-requirements",{":roles":22,"mcp":23,"scope":24,"tier":25},"[\"OWNER\",\"ADMIN\",\"MEMBER\"]","start_file_upload","files:write","3",[27,28,29],"p",{},"Starts a multipart file upload.",[31,32,33],"note",{},[34,35,36,40,56],"ol",{},[37,38,39],"li",{},"Split the file into 10,000,000-byte parts from the start. The last part holds whatever remains.",[37,41,42,43,47,48,51,52,55],{},"Within 30 minutes, upload each part with a PUT to the ",[44,45,46],"code",{},"url"," that has the same ",[44,49,50],{},"partNumber",", and keep the ",[44,53,54],{},"ETag"," header of each response.",[37,57,58,59,64,65,67,68,71],{},"Call ",[60,61,63],"a",{"href":62},"\u002Fapi-references\u002Ffile\u002Fcomplete-upload","Complete Multipart Upload"," with every ",[44,66,50],{}," and ",[44,69,70],{},"eTag",".",[73,74,76,81,143,314,355],"api-example",{"method":17,"url":18,"status":75},"201 Created",[77,78,80],"h2",{"id":79},"example","Example",[82,83,88],"pre",{"className":84,"code":85,"language":86,"meta":87,"style":87},"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\u002Ffiles\u002Fupload.multipart' \\\n  -H 'Authorization: Bearer YOUR_API_KEY' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{ \"name\": \"launch-cut.mp4\", \"size\": 25000000 }'\n","bash","",[44,89,90,113,124,134],{"__ignoreMap":87},[91,92,95,99,103,107,110],"span",{"class":93,"line":94},"line",1,[91,96,98],{"class":97},"s6MYo","curl",[91,100,102],{"class":101},"sTJUr"," -X",[91,104,106],{"class":105},"sHwJV"," POST",[91,108,109],{"class":105}," 'https:\u002F\u002Fapi.youvico.com\u002Fapi\u002Fprojects\u002Fbdbff5de-96d7-468f-9db0-85fe28bd6b62\u002Ffiles\u002Fupload.multipart'",[91,111,112],{"class":101}," \\\n",[91,114,116,119,122],{"class":93,"line":115},2,[91,117,118],{"class":101},"  -H",[91,120,121],{"class":105}," 'Authorization: Bearer YOUR_API_KEY'",[91,123,112],{"class":101},[91,125,127,129,132],{"class":93,"line":126},3,[91,128,118],{"class":101},[91,130,131],{"class":105}," 'Content-Type: application\u002Fjson'",[91,133,112],{"class":101},[91,135,137,140],{"class":93,"line":136},4,[91,138,139],{"class":101},"  -d",[91,141,142],{"class":105}," '{ \"name\": \"launch-cut.mp4\", \"size\": 25000000 }'\n",[82,144,148],{"className":145,"code":146,"language":147,"meta":87,"style":87},"language-json shiki shiki-themes ayu-light ayu-light ayu-dark","{\n  \"data\": {\n    \"id\": \"FX1234567890ABCD\",\n    \"parts\": [\n      {\n        \"partNumber\": 1,\n        \"url\": \"https:\u002F\u002Ffiles.youvico.com\u002Fupload\u002FeyJhbGciOiJFZERTQSIsImtpZCI6...\"\n      },\n      {\n        \"partNumber\": 2,\n        \"url\": \"https:\u002F\u002Ffiles.youvico.com\u002Fupload\u002FeyJhbGciOiJFZERTQSIsImtpZCI6...\"\n      },\n      {\n        \"partNumber\": 3,\n        \"url\": \"https:\u002F\u002Ffiles.youvico.com\u002Fupload\u002FeyJhbGciOiJFZERTQSIsImtpZCI6...\"\n      }\n    ]\n  }\n}\n","json",[44,149,150,156,169,182,192,198,212,223,231,236,248,257,264,269,281,290,296,302,308],{"__ignoreMap":87},[91,151,152],{"class":93,"line":94},[91,153,155],{"class":154},"snvv_","{\n",[91,157,158,162,166],{"class":93,"line":115},[91,159,161],{"class":160},"soLcz","  \"data\"",[91,163,165],{"class":164},"sgRSP",":",[91,167,168],{"class":154}," {\n",[91,170,171,174,176,179],{"class":93,"line":126},[91,172,173],{"class":160},"    \"id\"",[91,175,165],{"class":164},[91,177,178],{"class":105}," \"FX1234567890ABCD\"",[91,180,181],{"class":164},",\n",[91,183,184,187,189],{"class":93,"line":136},[91,185,186],{"class":160},"    \"parts\"",[91,188,165],{"class":164},[91,190,191],{"class":154}," [\n",[91,193,195],{"class":93,"line":194},5,[91,196,197],{"class":154},"      {\n",[91,199,201,204,206,210],{"class":93,"line":200},6,[91,202,203],{"class":160},"        \"partNumber\"",[91,205,165],{"class":164},[91,207,209],{"class":208},"ss_QQ"," 1",[91,211,181],{"class":164},[91,213,215,218,220],{"class":93,"line":214},7,[91,216,217],{"class":160},"        \"url\"",[91,219,165],{"class":164},[91,221,222],{"class":105}," \"https:\u002F\u002Ffiles.youvico.com\u002Fupload\u002FeyJhbGciOiJFZERTQSIsImtpZCI6...\"\n",[91,224,226,229],{"class":93,"line":225},8,[91,227,228],{"class":154},"      }",[91,230,181],{"class":164},[91,232,234],{"class":93,"line":233},9,[91,235,197],{"class":154},[91,237,239,241,243,246],{"class":93,"line":238},10,[91,240,203],{"class":160},[91,242,165],{"class":164},[91,244,245],{"class":208}," 2",[91,247,181],{"class":164},[91,249,251,253,255],{"class":93,"line":250},11,[91,252,217],{"class":160},[91,254,165],{"class":164},[91,256,222],{"class":105},[91,258,260,262],{"class":93,"line":259},12,[91,261,228],{"class":154},[91,263,181],{"class":164},[91,265,267],{"class":93,"line":266},13,[91,268,197],{"class":154},[91,270,272,274,276,279],{"class":93,"line":271},14,[91,273,203],{"class":160},[91,275,165],{"class":164},[91,277,278],{"class":208}," 3",[91,280,181],{"class":164},[91,282,284,286,288],{"class":93,"line":283},15,[91,285,217],{"class":160},[91,287,165],{"class":164},[91,289,222],{"class":105},[91,291,293],{"class":93,"line":292},16,[91,294,295],{"class":154},"      }\n",[91,297,299],{"class":93,"line":298},17,[91,300,301],{"class":154},"    ]\n",[91,303,305],{"class":93,"line":304},18,[91,306,307],{"class":154},"  }\n",[91,309,311],{"class":93,"line":310},19,[91,312,313],{"class":154},"}\n",[315,316,317],"template",{"v-slot:request":87},[82,318,319],{"className":84,"code":85,"language":86,"meta":87,"style":87},[44,320,321,333,341,349],{"__ignoreMap":87},[91,322,323,325,327,329,331],{"class":93,"line":94},[91,324,98],{"class":97},[91,326,102],{"class":101},[91,328,106],{"class":105},[91,330,109],{"class":105},[91,332,112],{"class":101},[91,334,335,337,339],{"class":93,"line":115},[91,336,118],{"class":101},[91,338,121],{"class":105},[91,340,112],{"class":101},[91,342,343,345,347],{"class":93,"line":126},[91,344,118],{"class":101},[91,346,131],{"class":105},[91,348,112],{"class":101},[91,350,351,353],{"class":93,"line":136},[91,352,139],{"class":101},[91,354,142],{"class":105},[315,356,357],{"v-slot:response":87},[82,358,359],{"className":145,"code":146,"language":147,"meta":87,"style":87},[44,360,361,365,373,383,391,395,405,413,419,423,433,441,447,451,461,469,473,477,481],{"__ignoreMap":87},[91,362,363],{"class":93,"line":94},[91,364,155],{"class":154},[91,366,367,369,371],{"class":93,"line":115},[91,368,161],{"class":160},[91,370,165],{"class":164},[91,372,168],{"class":154},[91,374,375,377,379,381],{"class":93,"line":126},[91,376,173],{"class":160},[91,378,165],{"class":164},[91,380,178],{"class":105},[91,382,181],{"class":164},[91,384,385,387,389],{"class":93,"line":136},[91,386,186],{"class":160},[91,388,165],{"class":164},[91,390,191],{"class":154},[91,392,393],{"class":93,"line":194},[91,394,197],{"class":154},[91,396,397,399,401,403],{"class":93,"line":200},[91,398,203],{"class":160},[91,400,165],{"class":164},[91,402,209],{"class":208},[91,404,181],{"class":164},[91,406,407,409,411],{"class":93,"line":214},[91,408,217],{"class":160},[91,410,165],{"class":164},[91,412,222],{"class":105},[91,414,415,417],{"class":93,"line":225},[91,416,228],{"class":154},[91,418,181],{"class":164},[91,420,421],{"class":93,"line":233},[91,422,197],{"class":154},[91,424,425,427,429,431],{"class":93,"line":238},[91,426,203],{"class":160},[91,428,165],{"class":164},[91,430,245],{"class":208},[91,432,181],{"class":164},[91,434,435,437,439],{"class":93,"line":250},[91,436,217],{"class":160},[91,438,165],{"class":164},[91,440,222],{"class":105},[91,442,443,445],{"class":93,"line":259},[91,444,228],{"class":154},[91,446,181],{"class":164},[91,448,449],{"class":93,"line":266},[91,450,197],{"class":154},[91,452,453,455,457,459],{"class":93,"line":271},[91,454,203],{"class":160},[91,456,165],{"class":164},[91,458,278],{"class":208},[91,460,181],{"class":164},[91,462,463,465,467],{"class":93,"line":283},[91,464,217],{"class":160},[91,466,165],{"class":164},[91,468,222],{"class":105},[91,470,471],{"class":93,"line":292},[91,472,295],{"class":154},[91,474,475],{"class":93,"line":298},[91,476,301],{"class":154},[91,478,479],{"class":93,"line":304},[91,480,307],{"class":154},[91,482,483],{"class":93,"line":310},[91,484,313],{"class":154},[77,486,488],{"id":487},"request","Request",[490,491,493],"h3",{"id":492},"path","Path",[495,496,500],"param-field",{"name":497,"type":498,":required":499},"id","string","true",[27,501,502],{},"Project ID",[490,504,506],{"id":505},"body","Body",[495,508,512],{"name":509,"type":498,"example":510,":required":499,"constraints":511},"name","launch-cut.mp4","1-255 characters",[27,513,514],{},"File name",[495,516,521],{"name":517,"type":518,"example":519,":required":499,"constraints":520},"size","number","25000000","Integer, 1-10000000000",[27,522,523],{},"File size in bytes",[77,525,527],{"id":526},"response","Response",[27,529,530,531,71],{},"Returns ",[44,532,75],{},[495,534,537],{"name":535,"type":536},"data","object",[27,538,539],{},"Upload session",[541,542,543,550,557],"param-children",{},[495,544,547],{"name":545,"type":498,"example":546,":indent":499},"data.id","FX1234567890ABCD",[27,548,549],{},"Created file ID",[495,551,554],{"name":552,"type":553,":indent":499},"data.parts","array",[27,555,556],{},"Upload parts",[541,558,559,566],{},[495,560,563],{"name":561,"type":518,"example":562,":indent":499},"data.parts[].partNumber","1",[27,564,565],{},"Part number",[495,567,570],{"name":568,"type":498,"example":569,":indent":499},"data.parts[].url","https:\u002F\u002Ffiles.youvico.com\u002Fupload\u002FeyJhbGciOiJFZERTQSIsImtpZCI6...",[27,571,572],{},"Part upload URL",[574,575,576],"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":87,"searchDepth":136,"depth":136,"links":578},[579,580,584],{"id":79,"depth":115,"text":80},{"id":487,"depth":115,"text":488,"children":581},[582,583],{"id":492,"depth":126,"text":493},{"id":505,"depth":126,"text":506},{"id":526,"depth":115,"text":527},"Start uploading a file to a project. Split it into 10 MB parts, PUT each one to its presigned URL within 30 minutes, then complete the upload.","md",null,{},"\u002Fapi-references\u002Ffile\u002Fupload-multipart",{"method":17,"path":18,"params":591,"body":594,"fields":595},[592],{"name":497,"example":593,"type":498,"required":6,"constraints":87,"description":502},"bdbff5de-96d7-468f-9db0-85fe28bd6b62","{\n  \"name\": \"launch-cut.mp4\",\n  \"size\": 25000000\n}",[596,600],{"key":509,"type":498,"required":6,"constraints":511,"description":514,"values":597,"array":598,"children":599},[],false,[],{"key":517,"type":518,"required":6,"constraints":520,"description":523,"values":601,"array":598,"children":602},[],[],{"title":5,"description":585},"api-references\u002Ffile\u002Fupload-multipart","bpxmrHB7hzXMR67b6vEdPAxBpGXb21ZJHwjWtWHa9fQ",1792305901641]