mudbase 1.0.0 → 1.1.4

data/docs/FilesApi.md

@@ -0,0 +1,702 @@
+# Mudbase::FilesApi
+
+All URIs are relative to *https://cloud.mudbase.dev*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**confirm_direct_upload**](FilesApi.md#confirm_direct_upload) | **POST** /api/files/upload/confirm | Confirm direct upload (scan + finalize metadata) |
+| [**delete_file**](FilesApi.md#delete_file) | **DELETE** /api/bucket/projects/{projectId}/buckets/{bucketId}/files/{fileId} | Delete file |
+| [**download_bucket_file**](FilesApi.md#download_bucket_file) | **GET** /api/bucket/files/{fileId}/download | Download file from bucket |
+| [**download_file**](FilesApi.md#download_file) | **GET** /api/files/{fileId}/download | Generate a presigned URL for downloading a file |
+| [**generate_presigned_upload**](FilesApi.md#generate_presigned_upload) | **POST** /api/files/upload/presigned | Generate presigned POST data for direct browser upload |
+| [**generate_signed_url**](FilesApi.md#generate_signed_url) | **POST** /api/bucket/projects/{projectId}/buckets/{bucketId}/files/{fileId}/signed-url | Generate signed URL for file |
+| [**get_file**](FilesApi.md#get_file) | **GET** /api/bucket/projects/{projectId}/buckets/{bucketId}/files/{fileId} | Get file metadata |
+| [**list_files**](FilesApi.md#list_files) | **GET** /api/bucket/projects/{projectId}/buckets/{bucketId}/files | List files in bucket |
+| [**upload_files**](FilesApi.md#upload_files) | **POST** /api/bucket/projects/{projectId}/buckets/{bucketId}/files | Upload files to bucket |
+
+
+## confirm_direct_upload
+
+> <ConfirmUploadResponse> confirm_direct_upload(confirm_direct_upload_request)
+
+Confirm direct upload (scan + finalize metadata)
+
+After a client uploads directly to S3 using the presigned POST, call this endpoint to have the server scan the object, create the File record, and optionally quarantine if infected.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure API key authorization: ApiKeyAuth
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::FilesApi.new
+confirm_direct_upload_request = Mudbase::ConfirmDirectUploadRequest.new({key: 'key_example', project_id: 'project_id_example'}) # ConfirmDirectUploadRequest | S3 key from presigned response, projectId, and optional originalName, contentType, size, bucket, isPublic.
+
+begin
+  # Confirm direct upload (scan + finalize metadata)
+  result = api_instance.confirm_direct_upload(confirm_direct_upload_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->confirm_direct_upload: #{e}"
+end
+```
+
+#### Using the confirm_direct_upload_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ConfirmUploadResponse>, Integer, Hash)> confirm_direct_upload_with_http_info(confirm_direct_upload_request)
+
+```ruby
+begin
+  # Confirm direct upload (scan + finalize metadata)
+  data, status_code, headers = api_instance.confirm_direct_upload_with_http_info(confirm_direct_upload_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ConfirmUploadResponse>
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->confirm_direct_upload_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **confirm_direct_upload_request** | [**ConfirmDirectUploadRequest**](ConfirmDirectUploadRequest.md) | S3 key from presigned response, projectId, and optional originalName, contentType, size, bucket, isPublic. |  |
+
+### Return type
+
+[**ConfirmUploadResponse**](ConfirmUploadResponse.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## delete_file
+
+> <MessageResponse> delete_file(project_id, bucket_id, file_id)
+
+Delete file
+
+Delete a file from a bucket permanently. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::FilesApi.new
+project_id = 'project_id_example' # String | Project ID.
+bucket_id = 'bucket_id_example' # String | Bucket ID.
+file_id = 'file_id_example' # String | File ID.
+
+begin
+  # Delete file
+  result = api_instance.delete_file(project_id, bucket_id, file_id)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->delete_file: #{e}"
+end
+```
+
+#### Using the delete_file_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<MessageResponse>, Integer, Hash)> delete_file_with_http_info(project_id, bucket_id, file_id)
+
+```ruby
+begin
+  # Delete file
+  data, status_code, headers = api_instance.delete_file_with_http_info(project_id, bucket_id, file_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <MessageResponse>
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->delete_file_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** | Project ID. |  |
+| **bucket_id** | **String** | Bucket ID. |  |
+| **file_id** | **String** | File ID. |  |
+
+### Return type
+
+[**MessageResponse**](MessageResponse.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## download_bucket_file
+
+> File download_bucket_file(file_id, opts)
+
+Download file from bucket
+
+Download a file from a bucket. For public files, no authentication is required. For private files, a download token (obtained via signed URL endpoint) is required in the query parameter. Accepts: Token-based authentication via query parameter (for private files), or no authentication (for public files). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+
+api_instance = Mudbase::FilesApi.new
+file_id = '685af8b85d73a104065b6a77' # String | File ID to download.
+opts = {
+  token: 'token_example' # String | Download token for private files (from signed URL endpoint).
+}
+
+begin
+  # Download file from bucket
+  result = api_instance.download_bucket_file(file_id, opts)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->download_bucket_file: #{e}"
+end
+```
+
+#### Using the download_bucket_file_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(File, Integer, Hash)> download_bucket_file_with_http_info(file_id, opts)
+
+```ruby
+begin
+  # Download file from bucket
+  data, status_code, headers = api_instance.download_bucket_file_with_http_info(file_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => File
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->download_bucket_file_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **file_id** | **String** | File ID to download. |  |
+| **token** | **String** | Download token for private files (from signed URL endpoint). | [optional] |
+
+### Return type
+
+**File**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/octet-stream, application/json
+
+
+## download_file
+
+> <SignedUrlResponse> download_file(file_id, opts)
+
+Generate a presigned URL for downloading a file
+
+Returns a time-limited provider-signed URL (S3) for direct download. Server enforces RBAC before issuing the URL.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure API key authorization: ApiKeyAuth
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::FilesApi.new
+file_id = 'file_id_example' # String | File ID.
+opts = {
+  token: 'token_example' # String | Optional one-time download token (if provided by upload flow).
+}
+
+begin
+  # Generate a presigned URL for downloading a file
+  result = api_instance.download_file(file_id, opts)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->download_file: #{e}"
+end
+```
+
+#### Using the download_file_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SignedUrlResponse>, Integer, Hash)> download_file_with_http_info(file_id, opts)
+
+```ruby
+begin
+  # Generate a presigned URL for downloading a file
+  data, status_code, headers = api_instance.download_file_with_http_info(file_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SignedUrlResponse>
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->download_file_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **file_id** | **String** | File ID. |  |
+| **token** | **String** | Optional one-time download token (if provided by upload flow). | [optional] |
+
+### Return type
+
+[**SignedUrlResponse**](SignedUrlResponse.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## generate_presigned_upload
+
+> <PresignedPostResponse> generate_presigned_upload(generate_presigned_upload_request)
+
+Generate presigned POST data for direct browser upload
+
+Issue a presigned POST (fields + url) for clients to upload directly to S3. The server stores the issued key with expiry and RBAC is enforced.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure API key authorization: ApiKeyAuth
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::FilesApi.new
+generate_presigned_upload_request = Mudbase::GeneratePresignedUploadRequest.new({project_id: 'project_id_example', original_name: 'original_name_example'}) # GeneratePresignedUploadRequest | projectId, originalName, optional bucket, contentType, isPublic.
+
+begin
+  # Generate presigned POST data for direct browser upload
+  result = api_instance.generate_presigned_upload(generate_presigned_upload_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->generate_presigned_upload: #{e}"
+end
+```
+
+#### Using the generate_presigned_upload_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<PresignedPostResponse>, Integer, Hash)> generate_presigned_upload_with_http_info(generate_presigned_upload_request)
+
+```ruby
+begin
+  # Generate presigned POST data for direct browser upload
+  data, status_code, headers = api_instance.generate_presigned_upload_with_http_info(generate_presigned_upload_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <PresignedPostResponse>
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->generate_presigned_upload_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **generate_presigned_upload_request** | [**GeneratePresignedUploadRequest**](GeneratePresignedUploadRequest.md) | projectId, originalName, optional bucket, contentType, isPublic. |  |
+
+### Return type
+
+[**PresignedPostResponse**](PresignedPostResponse.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## generate_signed_url
+
+> <SignedUrlResponse> generate_signed_url(project_id, bucket_id, file_id, opts)
+
+Generate signed URL for file
+
+Generate a time-limited signed URL for downloading a private file. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure API key authorization: ApiKeyAuth
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::FilesApi.new
+project_id = 'project_id_example' # String | Project ID.
+bucket_id = 'bucket_id_example' # String | Bucket ID.
+file_id = 'file_id_example' # String | File ID.
+opts = {
+  generate_signed_url_request: Mudbase::GenerateSignedUrlRequest.new # GenerateSignedUrlRequest | Optional expiresIn (seconds) for the signed URL.
+}
+
+begin
+  # Generate signed URL for file
+  result = api_instance.generate_signed_url(project_id, bucket_id, file_id, opts)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->generate_signed_url: #{e}"
+end
+```
+
+#### Using the generate_signed_url_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SignedUrlResponse>, Integer, Hash)> generate_signed_url_with_http_info(project_id, bucket_id, file_id, opts)
+
+```ruby
+begin
+  # Generate signed URL for file
+  data, status_code, headers = api_instance.generate_signed_url_with_http_info(project_id, bucket_id, file_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SignedUrlResponse>
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->generate_signed_url_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** | Project ID. |  |
+| **bucket_id** | **String** | Bucket ID. |  |
+| **file_id** | **String** | File ID. |  |
+| **generate_signed_url_request** | [**GenerateSignedUrlRequest**](GenerateSignedUrlRequest.md) | Optional expiresIn (seconds) for the signed URL. | [optional] |
+
+### Return type
+
+[**SignedUrlResponse**](SignedUrlResponse.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## get_file
+
+> <FileResponse> get_file(project_id, bucket_id, file_id)
+
+Get file metadata
+
+Get metadata for a specific file in a bucket. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure API key authorization: ApiKeyAuth
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::FilesApi.new
+project_id = 'project_id_example' # String | Project ID.
+bucket_id = 'bucket_id_example' # String | Bucket ID.
+file_id = 'file_id_example' # String | File ID.
+
+begin
+  # Get file metadata
+  result = api_instance.get_file(project_id, bucket_id, file_id)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->get_file: #{e}"
+end
+```
+
+#### Using the get_file_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<FileResponse>, Integer, Hash)> get_file_with_http_info(project_id, bucket_id, file_id)
+
+```ruby
+begin
+  # Get file metadata
+  data, status_code, headers = api_instance.get_file_with_http_info(project_id, bucket_id, file_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <FileResponse>
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->get_file_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** | Project ID. |  |
+| **bucket_id** | **String** | Bucket ID. |  |
+| **file_id** | **String** | File ID. |  |
+
+### Return type
+
+[**FileResponse**](FileResponse.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_files
+
+> <FileListResponse> list_files(project_id, bucket_id, opts)
+
+List files in bucket
+
+List files in a bucket with pagination, search, and optional type filter. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::FilesApi.new
+project_id = 'project_id_example' # String | Project ID.
+bucket_id = 'bucket_id_example' # String | Bucket ID.
+opts = {
+  page: 56, # Integer | Page number (1-based).
+  limit: 56, # Integer | Number of files per page.
+  search: 'search_example', # String | Search by filename.
+  type: 'type_example' # String | Filter by MIME type or file type.
+}
+
+begin
+  # List files in bucket
+  result = api_instance.list_files(project_id, bucket_id, opts)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->list_files: #{e}"
+end
+```
+
+#### Using the list_files_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<FileListResponse>, Integer, Hash)> list_files_with_http_info(project_id, bucket_id, opts)
+
+```ruby
+begin
+  # List files in bucket
+  data, status_code, headers = api_instance.list_files_with_http_info(project_id, bucket_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <FileListResponse>
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->list_files_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** | Project ID. |  |
+| **bucket_id** | **String** | Bucket ID. |  |
+| **page** | **Integer** | Page number (1-based). | [optional][default to 1] |
+| **limit** | **Integer** | Number of files per page. | [optional][default to 20] |
+| **search** | **String** | Search by filename. | [optional] |
+| **type** | **String** | Filter by MIME type or file type. | [optional] |
+
+### Return type
+
+[**FileListResponse**](FileListResponse.md)
+
+### Authorization
+
+[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## upload_files
+
+> <FileUploadResponse> upload_files(project_id, bucket_id, upload_files_to_bucket_request)
+
+Upload files to bucket
+
+Upload one or more files to a storage bucket using multipart/form-data. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure API key authorization: ApiKeyAuth
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::FilesApi.new
+project_id = 'project_id_example' # String | Project ID.
+bucket_id = 'bucket_id_example' # String | Bucket ID.
+upload_files_to_bucket_request = Mudbase::UploadFilesToBucketRequest.new({files: [File.new('/path/to/some/file')]}) # UploadFilesToBucketRequest | Use multipart/form-data for file upload (files required; optional folder, tags). application/json uses the same schema for metadata-only or tooling that prefers JSON.
+
+begin
+  # Upload files to bucket
+  result = api_instance.upload_files(project_id, bucket_id, upload_files_to_bucket_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->upload_files: #{e}"
+end
+```
+
+#### Using the upload_files_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<FileUploadResponse>, Integer, Hash)> upload_files_with_http_info(project_id, bucket_id, upload_files_to_bucket_request)
+
+```ruby
+begin
+  # Upload files to bucket
+  data, status_code, headers = api_instance.upload_files_with_http_info(project_id, bucket_id, upload_files_to_bucket_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <FileUploadResponse>
+rescue Mudbase::ApiError => e
+  puts "Error when calling FilesApi->upload_files_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** | Project ID. |  |
+| **bucket_id** | **String** | Bucket ID. |  |
+| **upload_files_to_bucket_request** | [**UploadFilesToBucketRequest**](UploadFilesToBucketRequest.md) | Use multipart/form-data for file upload (files required; optional folder, tags). application/json uses the same schema for metadata-only or tooling that prefers JSON. |  |
+
+### Return type
+
+[**FileUploadResponse**](FileUploadResponse.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json, multipart/form-data
+- **Accept**: application/json
+