The original name of the file to be uploaded. This is the filename provided in the request. Example: "product-image.jpg".

The complete storage path where the file will be stored in GCS. Auto-generated by the system based on the namespace rules. Format: /{namespace_path}/{hashed_filename}. This path is needed for the /complete API call after uploading. Example: "/misc/general/free/original/abc123-product-image.jpg".

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.

The HTTP method to use when uploading to the signed URL. Always "PUT" for file uploads. Use this method when making the request to upload.url. Example: "PUT".

The namespace that determines file storage rules, validation, path generation, and access control (public/private bucket). Examples: "misc" (public), "application-audience" (private), "products" (product images). Each namespace has specific allowed content types and size limits.

The storage operation type to perform. Always "putObject" for file uploads. Indicates this is a write operation to create a new object in the storage bucket. Example: "putObject".

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.

Contains the pre-signed upload URL and its expiration time.

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.