The request schema for initiating a file upload includes the file metadata such as name, content type, size, and optional tags.
Fields
file_name
String!Required
The original name of the file to be uploaded. This is the filename provided in the request. Example: "product-image.jpg".
content_type
String!Required
The MIME type of the file being uploaded. Must match one of the valid content types for the namespace. Examples: "image/jpeg", "application/pdf", "text/csv", "video/mp4". Used for validation and proper file handling by the storage service.
size
Int!Required
The size of the file in bytes. Must match the actual file size. Used for validation against namespace size limits. The system validates this before generating the upload URL. Example: 524288.
tags
[String]Optional array of string tags for categorizing and organizing the file. Tags can be provided in the request to attach metadata to the file. Can be used later for filtering and searching. Examples: ["product", "thumbnail"], ["invoice", "2024"], []. Defaults to empty array if not provided.
params
FileUploadParamsInputAdditional parameters for file processing and storage location.
Was this section helpful?