mudbase-sdk 1.1.8 → 1.2.1

package/docs/StorageApi.md

@@ -0,0 +1,1181 @@
+# StorageApi
+
+All URIs are relative to *https://cloud.mudbase.dev*
+
+| Method | HTTP request | Description |
+|------------- | ------------- | -------------|
+| [**storageConfirmUpload**](StorageApi.md#storageconfirmuploadoperation) | **POST** /api/files/upload/confirm | Confirm direct upload (scan + finalize metadata) |
+| [**storageCreateBucket**](StorageApi.md#storagecreatebucket) | **POST** /api/bucket/projects/{projectId}/buckets | Create a new bucket |
+| [**storageDeleteBucket**](StorageApi.md#storagedeletebucket) | **DELETE** /api/bucket/projects/{projectId}/buckets/{bucketId} | Delete bucket |
+| [**storageDeleteFile**](StorageApi.md#storagedeletefile) | **DELETE** /api/bucket/projects/{projectId}/buckets/{bucketId}/files/{fileId} | Delete file |
+| [**storageDownloadBucketFile**](StorageApi.md#storagedownloadbucketfile) | **GET** /api/bucket/files/{fileId}/download | Download file from bucket |
+| [**storageDownloadFile**](StorageApi.md#storagedownloadfile) | **GET** /api/files/{fileId}/download | Generate a presigned URL for downloading a file |
+| [**storageGetBucket**](StorageApi.md#storagegetbucket) | **GET** /api/bucket/projects/{projectId}/buckets/{bucketId} | Get bucket details |
+| [**storageGetFile**](StorageApi.md#storagegetfile) | **GET** /api/bucket/projects/{projectId}/buckets/{bucketId}/files/{fileId} | Get file metadata |
+| [**storageGetPresignedUpload**](StorageApi.md#storagegetpresigneduploadoperation) | **POST** /api/files/upload/presigned | Generate presigned POST data for direct browser upload |
+| [**storageGetSignedUrl**](StorageApi.md#storagegetsignedurloperation) | **POST** /api/bucket/projects/{projectId}/buckets/{bucketId}/files/{fileId}/signed-url | Generate signed URL for file |
+| [**storageListBuckets**](StorageApi.md#storagelistbuckets) | **GET** /api/bucket/projects/{projectId}/buckets | List buckets in a project |
+| [**storageListFiles**](StorageApi.md#storagelistfiles) | **GET** /api/bucket/projects/{projectId}/buckets/{bucketId}/files | List files in bucket |
+| [**storageUpdateBucket**](StorageApi.md#storageupdatebucket) | **PATCH** /api/bucket/projects/{projectId}/buckets/{bucketId} | Update bucket |
+| [**storageUploadFiles**](StorageApi.md#storageuploadfiles) | **POST** /api/bucket/projects/{projectId}/buckets/{bucketId}/files | Upload files to bucket |
+
+
+
+## storageConfirmUpload
+
+> ConfirmUploadResponse storageConfirmUpload(storageConfirmUploadRequest)
+
+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.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  StorageApi,
+} from 'mudbase-sdk';
+import type { StorageConfirmUploadOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: ApiKeyAuth
+    apiKey: "YOUR API KEY",
+    // Configure HTTP bearer authorization: BearerToken
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new StorageApi(config);
+
+  const body = {
+    // StorageConfirmUploadRequest | S3 key from presigned response, projectId, and optional originalName, contentType, size, bucket, isPublic.
+    storageConfirmUploadRequest: {"key":"65a1b2c3d4e5f6789012345a/default/abcd-1234-invoice.pdf","projectId":"65a1b2c3d4e5f6789012345a","originalName":"invoice.pdf","contentType":"application/pdf","size":52312,"isPublic":false},
+  } satisfies StorageConfirmUploadOperationRequest;
+
+  try {
+    const data = await api.storageConfirmUpload(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **storageConfirmUploadRequest** | [StorageConfirmUploadRequest](StorageConfirmUploadRequest.md) | S3 key from presigned response, projectId, and optional originalName, contentType, size, bucket, isPublic. | |
+
+### Return type
+
+[**ConfirmUploadResponse**](ConfirmUploadResponse.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **201** | File confirmed and metadata stored |  -  |
+| **400** | Bad request or file quarantined |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
+| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \"Authentication failed\", \"Failed to upload file\", \"Failed to fetch project\".  |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## storageCreateBucket
+
+> BucketResponse storageCreateBucket(projectId, createBucketRequest)
+
+Create a new bucket
+
+Create a new storage bucket in a project. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  StorageApi,
+} from 'mudbase-sdk';
+import type { StorageCreateBucketRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: ApiKeyAuth
+    apiKey: "YOUR API KEY",
+    // Configure HTTP bearer authorization: BearerToken
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new StorageApi(config);
+
+  const body = {
+    // string | Project ID.
+    projectId: projectId_example,
+    // CreateBucketRequest | Bucket name, isPublic flag, and optional settings.
+    createBucketRequest: {"name":"my-bucket","isPublic":false,"settings":{}},
+  } satisfies StorageCreateBucketRequest;
+
+  try {
+    const data = await api.storageCreateBucket(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` | Project ID. | [Defaults to `undefined`] |
+| **createBucketRequest** | [CreateBucketRequest](CreateBucketRequest.md) | Bucket name, isPublic flag, and optional settings. | |
+
+### Return type
+
+[**BucketResponse**](BucketResponse.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **201** | Bucket created successfully |  -  |
+| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
+| **409** | Resource conflict (e.g. \"Project with this slug already exists\", \"Webhook already succeeded\"). |  -  |
+| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \"Authentication failed\", \"Failed to upload file\", \"Failed to fetch project\".  |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## storageDeleteBucket
+
+> MessageResponse storageDeleteBucket(projectId, bucketId)
+
+Delete bucket
+
+Delete a storage bucket permanently. This is a destructive operation that will also delete all files in the bucket. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  StorageApi,
+} from 'mudbase-sdk';
+import type { StorageDeleteBucketRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: BearerToken
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new StorageApi(config);
+
+  const body = {
+    // string | Project ID.
+    projectId: projectId_example,
+    // string | Bucket ID.
+    bucketId: bucketId_example,
+  } satisfies StorageDeleteBucketRequest;
+
+  try {
+    const data = await api.storageDeleteBucket(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` | Project ID. | [Defaults to `undefined`] |
+| **bucketId** | `string` | Bucket ID. | [Defaults to `undefined`] |
+
+### Return type
+
+[**MessageResponse**](MessageResponse.md)
+
+### Authorization
+
+[BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Bucket deleted successfully |  -  |
+| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
+| **409** | Resource conflict (e.g. \"Project with this slug already exists\", \"Webhook already succeeded\"). |  -  |
+| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \"Authentication failed\", \"Failed to upload file\", \"Failed to fetch project\".  |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## storageDeleteFile
+
+> MessageResponse storageDeleteFile(projectId, bucketId, fileId)
+
+Delete file
+
+Delete a file from a bucket permanently. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  StorageApi,
+} from 'mudbase-sdk';
+import type { StorageDeleteFileRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: BearerToken
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new StorageApi(config);
+
+  const body = {
+    // string | Project ID.
+    projectId: projectId_example,
+    // string | Bucket ID.
+    bucketId: bucketId_example,
+    // string | File ID.
+    fileId: fileId_example,
+  } satisfies StorageDeleteFileRequest;
+
+  try {
+    const data = await api.storageDeleteFile(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` | Project ID. | [Defaults to `undefined`] |
+| **bucketId** | `string` | Bucket ID. | [Defaults to `undefined`] |
+| **fileId** | `string` | File ID. | [Defaults to `undefined`] |
+
+### Return type
+
+[**MessageResponse**](MessageResponse.md)
+
+### Authorization
+
+[BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | File deleted successfully |  -  |
+| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
+| **404** | File not found (exact backend message for file/storage endpoints). |  -  |
+| **409** | Resource conflict (e.g. \"Project with this slug already exists\", \"Webhook already succeeded\"). |  -  |
+| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \"API key rate limit exceeded\", \"Please wait before requesting another magic link\".  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \"Authentication failed\", \"Failed to upload file\", \"Failed to fetch project\".  |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## storageDownloadBucketFile
+
+> Blob storageDownloadBucketFile(fileId, token)
+
+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). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  StorageApi,
+} from 'mudbase-sdk';
+import type { StorageDownloadBucketFileRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new StorageApi();
+
+  const body = {
+    // string | File ID to download.
+    fileId: 685af8b85d73a104065b6a77,
+    // string | Download token for private files (from signed URL endpoint). (optional)
+    token: token_example,
+  } satisfies StorageDownloadBucketFileRequest;
+
+  try {
+    const data = await api.storageDownloadBucketFile(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **fileId** | `string` | File ID to download. | [Defaults to `undefined`] |
+| **token** | `string` | Download token for private files (from signed URL endpoint). | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+**Blob**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/octet-stream`, `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | File download |  * Content-Type -  <br>  * Content-Length -  <br>  * Content-Disposition -  <br>  |
+| **403** | Access denied or invalid token |  -  |
+| **404** | File not found |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## storageDownloadFile
+
+> SignedUrlResponse storageDownloadFile(fileId, token)
+
+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.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  StorageApi,
+} from 'mudbase-sdk';
+import type { StorageDownloadFileRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: ApiKeyAuth
+    apiKey: "YOUR API KEY",
+    // Configure HTTP bearer authorization: BearerToken
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new StorageApi(config);
+
+  const body = {
+    // string | File ID.
+    fileId: fileId_example,
+    // string | Optional one-time download token (if provided by upload flow). (optional)
+    token: token_example,
+  } satisfies StorageDownloadFileRequest;
+
+  try {
+    const data = await api.storageDownloadFile(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **fileId** | `string` | File ID. | [Defaults to `undefined`] |
+| **token** | `string` | Optional one-time download token (if provided by upload flow). | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**SignedUrlResponse**](SignedUrlResponse.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Signed URL generated |  -  |
+| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \&quot;Validation failed\&quot;, \&quot;projectId is required\&quot;, \&quot;No file provided\&quot;, \&quot;Invalid project ID format\&quot;. **details** may contain validation errors when present.  |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \&quot;Invalid token.\&quot;, \&quot;Access denied. No token provided.\&quot;, \&quot;Authentication required\&quot;, \&quot;Invalid API key\&quot;, \&quot;API key expired\&quot;.  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \&quot;Access denied\&quot;, \&quot;Insufficient permissions\&quot;, \&quot;You don\&#39;t have permission to view this organization\&#39;s projects\&quot;, \&quot;Account suspended\&quot;.  |  -  |
+| **404** | File not found (exact backend message for file/storage endpoints). |  -  |
+| **409** | Resource conflict (e.g. \&quot;Project with this slug already exists\&quot;, \&quot;Webhook already succeeded\&quot;). |  -  |
+| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \&quot;API key rate limit exceeded\&quot;, \&quot;Please wait before requesting another magic link\&quot;.  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \&quot;Authentication failed\&quot;, \&quot;Failed to upload file\&quot;, \&quot;Failed to fetch project\&quot;.  |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## storageGetBucket
+
+> BucketResponse storageGetBucket(projectId, bucketId)
+
+Get bucket details
+
+Retrieve metadata and configuration for a single storage bucket, including name, project, public/private status, and settings. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  StorageApi,
+} from 'mudbase-sdk';
+import type { StorageGetBucketRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: ApiKeyAuth
+    apiKey: "YOUR API KEY",
+    // Configure HTTP bearer authorization: BearerToken
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new StorageApi(config);
+
+  const body = {
+    // string | Project ID.
+    projectId: projectId_example,
+    // string | Bucket ID.
+    bucketId: bucketId_example,
+  } satisfies StorageGetBucketRequest;
+
+  try {
+    const data = await api.storageGetBucket(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` | Project ID. | [Defaults to `undefined`] |
+| **bucketId** | `string` | Bucket ID. | [Defaults to `undefined`] |
+
+### Return type
+
+[**BucketResponse**](BucketResponse.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Bucket details |  -  |
+| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \&quot;Validation failed\&quot;, \&quot;projectId is required\&quot;, \&quot;No file provided\&quot;, \&quot;Invalid project ID format\&quot;. **details** may contain validation errors when present.  |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \&quot;Invalid token.\&quot;, \&quot;Access denied. No token provided.\&quot;, \&quot;Authentication required\&quot;, \&quot;Invalid API key\&quot;, \&quot;API key expired\&quot;.  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \&quot;Access denied\&quot;, \&quot;Insufficient permissions\&quot;, \&quot;You don\&#39;t have permission to view this organization\&#39;s projects\&quot;, \&quot;Account suspended\&quot;.  |  -  |
+| **409** | Resource conflict (e.g. \&quot;Project with this slug already exists\&quot;, \&quot;Webhook already succeeded\&quot;). |  -  |
+| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \&quot;API key rate limit exceeded\&quot;, \&quot;Please wait before requesting another magic link\&quot;.  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \&quot;Authentication failed\&quot;, \&quot;Failed to upload file\&quot;, \&quot;Failed to fetch project\&quot;.  |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## storageGetFile
+
+> FileResponse storageGetFile(projectId, bucketId, fileId)
+
+Get file metadata
+
+Get metadata for a specific file in a bucket. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  StorageApi,
+} from 'mudbase-sdk';
+import type { StorageGetFileRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: ApiKeyAuth
+    apiKey: "YOUR API KEY",
+    // Configure HTTP bearer authorization: BearerToken
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new StorageApi(config);
+
+  const body = {
+    // string | Project ID.
+    projectId: projectId_example,
+    // string | Bucket ID.
+    bucketId: bucketId_example,
+    // string | File ID.
+    fileId: fileId_example,
+  } satisfies StorageGetFileRequest;
+
+  try {
+    const data = await api.storageGetFile(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` | Project ID. | [Defaults to `undefined`] |
+| **bucketId** | `string` | Bucket ID. | [Defaults to `undefined`] |
+| **fileId** | `string` | File ID. | [Defaults to `undefined`] |
+
+### Return type
+
+[**FileResponse**](FileResponse.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | File metadata |  -  |
+| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \&quot;Validation failed\&quot;, \&quot;projectId is required\&quot;, \&quot;No file provided\&quot;, \&quot;Invalid project ID format\&quot;. **details** may contain validation errors when present.  |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \&quot;Invalid token.\&quot;, \&quot;Access denied. No token provided.\&quot;, \&quot;Authentication required\&quot;, \&quot;Invalid API key\&quot;, \&quot;API key expired\&quot;.  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \&quot;Access denied\&quot;, \&quot;Insufficient permissions\&quot;, \&quot;You don\&#39;t have permission to view this organization\&#39;s projects\&quot;, \&quot;Account suspended\&quot;.  |  -  |
+| **404** | File not found (exact backend message for file/storage endpoints). |  -  |
+| **409** | Resource conflict (e.g. \&quot;Project with this slug already exists\&quot;, \&quot;Webhook already succeeded\&quot;). |  -  |
+| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \&quot;API key rate limit exceeded\&quot;, \&quot;Please wait before requesting another magic link\&quot;.  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \&quot;Authentication failed\&quot;, \&quot;Failed to upload file\&quot;, \&quot;Failed to fetch project\&quot;.  |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## storageGetPresignedUpload
+
+> PresignedPostResponse storageGetPresignedUpload(storageGetPresignedUploadRequest)
+
+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.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  StorageApi,
+} from 'mudbase-sdk';
+import type { StorageGetPresignedUploadOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: ApiKeyAuth
+    apiKey: "YOUR API KEY",
+    // Configure HTTP bearer authorization: BearerToken
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new StorageApi(config);
+
+  const body = {
+    // StorageGetPresignedUploadRequest | projectId, originalName, optional bucket, contentType, isPublic.
+    storageGetPresignedUploadRequest: {"projectId":"65a1b2c3d4e5f6789012345a","bucket":"default","originalName":"invoice.pdf","contentType":"application/pdf","isPublic":false},
+  } satisfies StorageGetPresignedUploadOperationRequest;
+
+  try {
+    const data = await api.storageGetPresignedUpload(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **storageGetPresignedUploadRequest** | [StorageGetPresignedUploadRequest](StorageGetPresignedUploadRequest.md) | projectId, originalName, optional bucket, contentType, isPublic. | |
+
+### Return type
+
+[**PresignedPostResponse**](PresignedPostResponse.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Presigned POST data |  -  |
+| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \&quot;Validation failed\&quot;, \&quot;projectId is required\&quot;, \&quot;No file provided\&quot;, \&quot;Invalid project ID format\&quot;. **details** may contain validation errors when present.  |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \&quot;Invalid token.\&quot;, \&quot;Access denied. No token provided.\&quot;, \&quot;Authentication required\&quot;, \&quot;Invalid API key\&quot;, \&quot;API key expired\&quot;.  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \&quot;Access denied\&quot;, \&quot;Insufficient permissions\&quot;, \&quot;You don\&#39;t have permission to view this organization\&#39;s projects\&quot;, \&quot;Account suspended\&quot;.  |  -  |
+| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \&quot;API key rate limit exceeded\&quot;, \&quot;Please wait before requesting another magic link\&quot;.  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \&quot;Authentication failed\&quot;, \&quot;Failed to upload file\&quot;, \&quot;Failed to fetch project\&quot;.  |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## storageGetSignedUrl
+
+> SignedUrlResponse storageGetSignedUrl(projectId, bucketId, fileId, storageGetSignedUrlRequest)
+
+Generate signed URL for file
+
+Generate a time-limited signed URL for downloading a private file. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  StorageApi,
+} from 'mudbase-sdk';
+import type { StorageGetSignedUrlOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: ApiKeyAuth
+    apiKey: "YOUR API KEY",
+    // Configure HTTP bearer authorization: BearerToken
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new StorageApi(config);
+
+  const body = {
+    // string | Project ID.
+    projectId: projectId_example,
+    // string | Bucket ID.
+    bucketId: bucketId_example,
+    // string | File ID.
+    fileId: fileId_example,
+    // StorageGetSignedUrlRequest | Optional expiresIn (seconds) for the signed URL. (optional)
+    storageGetSignedUrlRequest: {"expiresIn":3600},
+  } satisfies StorageGetSignedUrlOperationRequest;
+
+  try {
+    const data = await api.storageGetSignedUrl(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` | Project ID. | [Defaults to `undefined`] |
+| **bucketId** | `string` | Bucket ID. | [Defaults to `undefined`] |
+| **fileId** | `string` | File ID. | [Defaults to `undefined`] |
+| **storageGetSignedUrlRequest** | [StorageGetSignedUrlRequest](StorageGetSignedUrlRequest.md) | Optional expiresIn (seconds) for the signed URL. | [Optional] |
+
+### Return type
+
+[**SignedUrlResponse**](SignedUrlResponse.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth), [BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Signed URL generated |  -  |
+| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \&quot;Validation failed\&quot;, \&quot;projectId is required\&quot;, \&quot;No file provided\&quot;, \&quot;Invalid project ID format\&quot;. **details** may contain validation errors when present.  |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \&quot;Invalid token.\&quot;, \&quot;Access denied. No token provided.\&quot;, \&quot;Authentication required\&quot;, \&quot;Invalid API key\&quot;, \&quot;API key expired\&quot;.  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \&quot;Access denied\&quot;, \&quot;Insufficient permissions\&quot;, \&quot;You don\&#39;t have permission to view this organization\&#39;s projects\&quot;, \&quot;Account suspended\&quot;.  |  -  |
+| **409** | Resource conflict (e.g. \&quot;Project with this slug already exists\&quot;, \&quot;Webhook already succeeded\&quot;). |  -  |
+| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \&quot;API key rate limit exceeded\&quot;, \&quot;Please wait before requesting another magic link\&quot;.  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \&quot;Authentication failed\&quot;, \&quot;Failed to upload file\&quot;, \&quot;Failed to fetch project\&quot;.  |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## storageListBuckets
+
+> BucketListResponse storageListBuckets(projectId, page, limit, search)
+
+List buckets in a project
+
+List all storage buckets in a project with pagination and search. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  StorageApi,
+} from 'mudbase-sdk';
+import type { StorageListBucketsRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: BearerToken
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new StorageApi(config);
+
+  const body = {
+    // string | Project ID.
+    projectId: projectId_example,
+    // number | Page number (1-based). (optional)
+    page: 56,
+    // number | Number of buckets per page. (optional)
+    limit: 56,
+    // string | Search by bucket name. (optional)
+    search: search_example,
+  } satisfies StorageListBucketsRequest;
+
+  try {
+    const data = await api.storageListBuckets(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` | Project ID. | [Defaults to `undefined`] |
+| **page** | `number` | Page number (1-based). | [Optional] [Defaults to `1`] |
+| **limit** | `number` | Number of buckets per page. | [Optional] [Defaults to `20`] |
+| **search** | `string` | Search by bucket name. | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**BucketListResponse**](BucketListResponse.md)
+
+### Authorization
+
+[BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | List of buckets |  -  |
+| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \&quot;Validation failed\&quot;, \&quot;projectId is required\&quot;, \&quot;No file provided\&quot;, \&quot;Invalid project ID format\&quot;. **details** may contain validation errors when present.  |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \&quot;Invalid token.\&quot;, \&quot;Access denied. No token provided.\&quot;, \&quot;Authentication required\&quot;, \&quot;Invalid API key\&quot;, \&quot;API key expired\&quot;.  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \&quot;Access denied\&quot;, \&quot;Insufficient permissions\&quot;, \&quot;You don\&#39;t have permission to view this organization\&#39;s projects\&quot;, \&quot;Account suspended\&quot;.  |  -  |
+| **409** | Resource conflict (e.g. \&quot;Project with this slug already exists\&quot;, \&quot;Webhook already succeeded\&quot;). |  -  |
+| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \&quot;API key rate limit exceeded\&quot;, \&quot;Please wait before requesting another magic link\&quot;.  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \&quot;Authentication failed\&quot;, \&quot;Failed to upload file\&quot;, \&quot;Failed to fetch project\&quot;.  |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## storageListFiles
+
+> FileListResponse storageListFiles(projectId, bucketId, page, limit, search, type)
+
+List files in bucket
+
+List files in a bucket with pagination, search, and optional type filter. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  StorageApi,
+} from 'mudbase-sdk';
+import type { StorageListFilesRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: BearerToken
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new StorageApi(config);
+
+  const body = {
+    // string | Project ID.
+    projectId: projectId_example,
+    // string | Bucket ID.
+    bucketId: bucketId_example,
+    // number | Page number (1-based). (optional)
+    page: 56,
+    // number | Number of files per page. (optional)
+    limit: 56,
+    // string | Search by filename. (optional)
+    search: search_example,
+    // string | Filter by MIME type or file type. (optional)
+    type: type_example,
+  } satisfies StorageListFilesRequest;
+
+  try {
+    const data = await api.storageListFiles(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` | Project ID. | [Defaults to `undefined`] |
+| **bucketId** | `string` | Bucket ID. | [Defaults to `undefined`] |
+| **page** | `number` | Page number (1-based). | [Optional] [Defaults to `1`] |
+| **limit** | `number` | Number of files per page. | [Optional] [Defaults to `20`] |
+| **search** | `string` | Search by filename. | [Optional] [Defaults to `undefined`] |
+| **type** | `string` | Filter by MIME type or file type. | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**FileListResponse**](FileListResponse.md)
+
+### Authorization
+
+[BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | List of files |  -  |
+| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \&quot;Validation failed\&quot;, \&quot;projectId is required\&quot;, \&quot;No file provided\&quot;, \&quot;Invalid project ID format\&quot;. **details** may contain validation errors when present.  |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \&quot;Invalid token.\&quot;, \&quot;Access denied. No token provided.\&quot;, \&quot;Authentication required\&quot;, \&quot;Invalid API key\&quot;, \&quot;API key expired\&quot;.  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \&quot;Access denied\&quot;, \&quot;Insufficient permissions\&quot;, \&quot;You don\&#39;t have permission to view this organization\&#39;s projects\&quot;, \&quot;Account suspended\&quot;.  |  -  |
+| **409** | Resource conflict (e.g. \&quot;Project with this slug already exists\&quot;, \&quot;Webhook already succeeded\&quot;). |  -  |
+| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \&quot;API key rate limit exceeded\&quot;, \&quot;Please wait before requesting another magic link\&quot;.  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \&quot;Authentication failed\&quot;, \&quot;Failed to upload file\&quot;, \&quot;Failed to fetch project\&quot;.  |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## storageUpdateBucket
+
+> BucketResponse storageUpdateBucket(projectId, bucketId, updateBucketRequest)
+
+Update bucket
+
+Update bucket configuration (name, public/private status, settings). Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  StorageApi,
+} from 'mudbase-sdk';
+import type { StorageUpdateBucketRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: BearerToken
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new StorageApi(config);
+
+  const body = {
+    // string | Project ID.
+    projectId: projectId_example,
+    // string | Bucket ID.
+    bucketId: bucketId_example,
+    // UpdateBucketRequest | Fields to update (name, isPublic, settings).
+    updateBucketRequest: {"name":"my-bucket-updated","isPublic":true,"settings":{}},
+  } satisfies StorageUpdateBucketRequest;
+
+  try {
+    const data = await api.storageUpdateBucket(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` | Project ID. | [Defaults to `undefined`] |
+| **bucketId** | `string` | Bucket ID. | [Defaults to `undefined`] |
+| **updateBucketRequest** | [UpdateBucketRequest](UpdateBucketRequest.md) | Fields to update (name, isPublic, settings). | |
+
+### Return type
+
+[**BucketResponse**](BucketResponse.md)
+
+### Authorization
+
+[BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Bucket updated successfully |  -  |
+| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \&quot;Validation failed\&quot;, \&quot;projectId is required\&quot;, \&quot;No file provided\&quot;, \&quot;Invalid project ID format\&quot;. **details** may contain validation errors when present.  |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \&quot;Invalid token.\&quot;, \&quot;Access denied. No token provided.\&quot;, \&quot;Authentication required\&quot;, \&quot;Invalid API key\&quot;, \&quot;API key expired\&quot;.  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \&quot;Access denied\&quot;, \&quot;Insufficient permissions\&quot;, \&quot;You don\&#39;t have permission to view this organization\&#39;s projects\&quot;, \&quot;Account suspended\&quot;.  |  -  |
+| **409** | Resource conflict (e.g. \&quot;Project with this slug already exists\&quot;, \&quot;Webhook already succeeded\&quot;). |  -  |
+| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \&quot;API key rate limit exceeded\&quot;, \&quot;Please wait before requesting another magic link\&quot;.  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \&quot;Authentication failed\&quot;, \&quot;Failed to upload file\&quot;, \&quot;Failed to fetch project\&quot;.  |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## storageUploadFiles
+
+> FileUploadResponse storageUploadFiles(projectId, bucketId, uploadFilesToBucketRequest)
+
+Upload files to bucket
+
+Upload one or more files to a storage bucket using multipart/form-data. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  StorageApi,
+} from 'mudbase-sdk';
+import type { StorageUploadFilesRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: ApiKeyAuth
+    apiKey: "YOUR API KEY",
+    // Configure HTTP bearer authorization: BearerToken
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new StorageApi(config);
+
+  const body = {
+    // string | Project ID.
+    projectId: projectId_example,
+    // string | Bucket ID.
+    bucketId: bucketId_example,
+    // 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.
+    uploadFilesToBucketRequest: ...,
+  } satisfies StorageUploadFilesRequest;
+
+  try {
+    const data = await api.storageUploadFiles(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` | Project ID. | [Defaults to `undefined`] |
+| **bucketId** | `string` | Bucket ID. | [Defaults to `undefined`] |
+| **uploadFilesToBucketRequest** | [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), [BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`, `multipart/form-data`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **201** | Files uploaded successfully |  -  |
+| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \&quot;Validation failed\&quot;, \&quot;projectId is required\&quot;, \&quot;No file provided\&quot;, \&quot;Invalid project ID format\&quot;. **details** may contain validation errors when present.  |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \&quot;Invalid token.\&quot;, \&quot;Access denied. No token provided.\&quot;, \&quot;Authentication required\&quot;, \&quot;Invalid API key\&quot;, \&quot;API key expired\&quot;.  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \&quot;Access denied\&quot;, \&quot;Insufficient permissions\&quot;, \&quot;You don\&#39;t have permission to view this organization\&#39;s projects\&quot;, \&quot;Account suspended\&quot;.  |  -  |
+| **409** | Resource conflict (e.g. \&quot;Project with this slug already exists\&quot;, \&quot;Webhook already succeeded\&quot;). |  -  |
+| **429** | Rate limit exceeded. The **error** field contains the exact backend message, e.g. \&quot;API key rate limit exceeded\&quot;, \&quot;Please wait before requesting another magic link\&quot;.  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \&quot;Authentication failed\&quot;, \&quot;Failed to upload file\&quot;, \&quot;Failed to fetch project\&quot;.  |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+