Skip to main content
inputCreateUploadSessionInput

Fields

assetKind
UploadAssetKind!
required
assetStyle
UploadAssetStyle!
required
clientMutationId
String

A unique identifier for the client performing the mutation.

contentType
String

MIME type of the source file; stored in placeholder asset metadata

fileName
String!
required
fileSizeBytes
Long!
required
maxParallelSupported
Int

How many part uploads this client can keep in flight. Omit it (or send 1) and the session is planned for sequential upload, which is what every client that does not implement concurrency should do. Declaring more than 1 lets the server grant a wider max_parallel; it does not oblige the client to use the full width it is granted, and it does not change the part size.

preferredChunkSizeBytes
Long

Part size this client would like, in bytes. Honored by the direct-presigned strategy, clamped to a range whose floor is the shared default — so a client can ask for larger parts than the default but never smaller. Larger parts mean fewer requests and a costlier retry, since a failed part is re-uploaded whole. Omit it to get the shared default. The server-mediated strategy ignores it.

preferredStrategy
UploadStrategy

Advisory. Must match the asset_kind's bound strategy or the manager rejects.

spaceId
ID!
required

ID of the space to upload into — resource ID or GlobalID.