Start Multipart Upload

MCP Tool

start_file_uploadStart File Upload

Rate Limit

Tier 3

Scope

files:write

Project Role

OwnerManagerMember

Starts a multipart file upload.

Info

Upload each part to its URL, then call Complete Multipart Upload.

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

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

data.parts[].partNumbernumber

Part number

Example: 1

data.parts[].urlstring

Part upload URL

Example: https://files.youvico.com/upload/eyJhbGciOiJFZERTQSIsImtpZCI6...