Create upload - Veryfront

createUpload(input: CreateUploadInput!): UploadSession!

Requires project.uploads.write.

Arguments

Argument	Type	Required
`input`	`CreateUploadInput!`	Yes

Input fields

input

CreateUploadInput

Field	Type	Required	Description
`projectReference`	`String!`	Yes	Project UUID, slug or configured domain.
`path`	`String!`	Yes	Project-relative destination path, for example assets/image.png. Leading slashes are stripped.
`contentType`	`String`	No	MIME type; it becomes a required header of the PUT request.
`sizeBytes`	`Float!`	Yes	File size in bytes, a positive integer of at most 9007199254740991, checked against the storage quota.

Response

Returns UploadSession!. Open the type for its fields and nested types.

Field	Type	Description
`uploadId`	`ID!`	UUID of the pending upload.
`path`	`String!`	Project-relative path of the upload.
`uploadUrl`	`String!`	Short-lived signed URL for the PUT request that sends the bytes.
`requiredHeaders`	`StringMap!`	Headers the PUT request must send.
`status`	`UploadMetadataStatus!`	Always pending until the bytes are stored.

Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

mutation CreateUpload($input: CreateUploadInput!) {
  createUpload(input: $input) {
    status
    path
    requiredHeaders
    uploadId
    uploadUrl
  }
}

{
  "input": {
    "projectReference": "00000000-0000-4000-8000-000000000001",
    "path": "example",
    "sizeBytes": 0
  }
}