Start Upload

MCP tool

start_generation_attachment_uploadStart Generation Attachment Upload

Rate limit

Tier 3

Scope

ai:generate

Project role

OwnerManagerMember

Starts uploading a reference file for Generate File.

Info

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

Example

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

{
  "data": {
    "id": "GA1234567890ABCD",
    "parts": [
      {
        "partNumber": 1,
        "url": "https://example.com/upload/1"
      }
    ]
  }
}

Request

Path

idstringrequired

Project ID

Body

namestringrequired

1-255 characters

Attachment file name

Example: reference.png

sizenumberrequired

Integer, 1-1000000000

Attachment size in bytes

Example: 2400000

Response

Returns 201 Created.

dataobject

Upload session

data.idstring

Created generation attachment ID

Example: GA1234567890ABCD

data.partsarray

Upload parts

data.parts[].partNumbernumber

Part number

Example: 1

data.parts[].urlstring

Presigned part upload URL

Example: https://example.com/upload/1