Beta

API ReferenceFile

Start Multipart Upload

POSThttps://api.youvico.com/api/projects/:id/files/upload.multipart
MCP Tool
start_file_uploadStart File Upload
Rate Limit
Tier 3
Scope
files:write
Project Role
OwnerManagerMember

Starts a multipart file upload.

Note

  1. Split the file into 10,000,000-byte parts from the start. The last part holds whatever remains.
  2. Within 30 minutes, upload each part with a PUT to the url that has the same partNumber, and keep the ETag header of each response.
  3. Call Complete Multipart Upload with every partNumber and eTag.

Example

curl -X POST 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/files/upload.multipart' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "name": "launch-cut.mp4", "size": 25000000 }'

{
  "data": {
    "id": "FX1234567890ABCD",
    "parts": [
      {
        "partNumber": 1,
        "url": "https://files.youvico.com/upload/eyJhbGciOiJFZERTQSIsImtpZCI6..."
      },
      {
        "partNumber": 2,
        "url": "https://files.youvico.com/upload/eyJhbGciOiJFZERTQSIsImtpZCI6..."
      },
      {
        "partNumber": 3,
        "url": "https://files.youvico.com/upload/eyJhbGciOiJFZERTQSIsImtpZCI6..."
      }
    ]
  }
}
Request
curl -X POST 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/files/upload.multipart' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"name": "launch-cut.mp4",
"size": 25000000
}'
Response201 Created
{
  "data": {
    "id": "FX1234567890ABCD",
    "parts": [
      {
        "partNumber": 1,
        "url": "https://files.youvico.com/upload/eyJhbGciOiJFZERTQSIsImtpZCI6..."
      },
      {
        "partNumber": 2,
        "url": "https://files.youvico.com/upload/eyJhbGciOiJFZERTQSIsImtpZCI6..."
      },
      {
        "partNumber": 3,
        "url": "https://files.youvico.com/upload/eyJhbGciOiJFZERTQSIsImtpZCI6..."
      }
    ]
  }
}

Request

Path

idstringrequired
Project ID

Body

namestringrequired

1-255 characters

File name

Example: launch-cut.mp4

sizenumberrequired

Integer, 1-10000000000

File size in bytes

Example: 25000000

Response

Returns 201 Created.

dataobject
Upload session
data.idstring
Created file ID

Example: FX1234567890ABCD

data.partsarray
Upload parts