mudbase-sdk 1.1.9 → 1.2.1

package/docs/CollectionsList200Response.md

@@ -0,0 +1,36 @@
+
+# CollectionsList200Response
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`collections` | [Array<Collection>](Collection.md)
+`total` | number
+
+## Example
+
+```typescript
+import type { CollectionsList200Response } from 'mudbase-sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "collections": null,
+  "total": null,
+} satisfies CollectionsList200Response
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as CollectionsList200Response
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/ComplianceApi.md

@@ -4,13 +4,13 @@ All URIs are relative to *https://cloud.mudbase.dev*
 
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
-| [**logSecurityEvent**](ComplianceApi.md#logsecurityeventoperation) | **POST** /api/compliance/security-event | Log security event |
+| [**complianceLogSecurityEvent**](ComplianceApi.md#compliancelogsecurityeventoperation) | **POST** /api/compliance/security-event | Log security event |
 
 
 
-## logSecurityEvent
+## complianceLogSecurityEvent
 
-> LogSecurityEvent200Response logSecurityEvent(logSecurityEventRequest)
+> ComplianceLogSecurityEvent200Response complianceLogSecurityEvent(complianceLogSecurityEventRequest)
 
 Log security event
 
@@ -23,23 +23,23 @@ import {
   Configuration,
   ComplianceApi,
 } from 'mudbase-sdk';
-import type { LogSecurityEventOperationRequest } from 'mudbase-sdk';
+import type { ComplianceLogSecurityEventOperationRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: ProjectBearerAuth
+    // Configure HTTP bearer authorization: BearerToken
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new ComplianceApi(config);
 
   const body = {
-    // LogSecurityEventRequest | Event type (e.g. unauthorized_access_attempt, brute_force_attempt), severity (low–critical), and optional details object for context.
-    logSecurityEventRequest: {"eventType":"unauthorized_access_attempt","severity":"high","details":{"userId":"685acbe0e129932fbb7a0fc2","resource":"admin-panel","ipAddress":"192.168.1.100","action":"blocked","reason":"Insufficient permissions"}},
-  } satisfies LogSecurityEventOperationRequest;
+    // ComplianceLogSecurityEventRequest | Event type (e.g. unauthorized_access_attempt, brute_force_attempt), severity (low–critical), and optional details object for context.
+    complianceLogSecurityEventRequest: {"eventType":"unauthorized_access_attempt","severity":"high","details":{"userId":"685acbe0e129932fbb7a0fc2","resource":"admin-panel","ipAddress":"192.168.1.100","action":"blocked","reason":"Insufficient permissions"}},
+  } satisfies ComplianceLogSecurityEventOperationRequest;
 
   try {
-    const data = await api.logSecurityEvent(body);
+    const data = await api.complianceLogSecurityEvent(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -55,15 +55,15 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **logSecurityEventRequest** | [LogSecurityEventRequest](LogSecurityEventRequest.md) | Event type (e.g. unauthorized_access_attempt, brute_force_attempt), severity (low–critical), and optional details object for context. | |
+| **complianceLogSecurityEventRequest** | [ComplianceLogSecurityEventRequest](ComplianceLogSecurityEventRequest.md) | Event type (e.g. unauthorized_access_attempt, brute_force_attempt), severity (low–critical), and optional details object for context. | |
 
 ### Return type
 
-[**LogSecurityEvent200Response**](LogSecurityEvent200Response.md)
+[**ComplianceLogSecurityEvent200Response**](ComplianceLogSecurityEvent200Response.md)
 
 ### Authorization
 
-[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+[BearerToken](../README.md#BearerToken)
 
 ### HTTP request headers
 
@@ -75,8 +75,8 @@ example().catch(console.error);
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 | **200** | Security event logged |  -  |
-| **400** | Bad request |  -  |
-| **401** | Authentication required |  -  |
+| **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\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 

package/docs/ComplianceLogSecurityEvent200Response.md

@@ -0,0 +1,36 @@
+
+# ComplianceLogSecurityEvent200Response
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`message` | string
+`event` | [ComplianceLogSecurityEvent200ResponseEvent](ComplianceLogSecurityEvent200ResponseEvent.md)
+
+## Example
+
+```typescript
+import type { ComplianceLogSecurityEvent200Response } from 'mudbase-sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "message": Security event logged,
+  "event": null,
+} satisfies ComplianceLogSecurityEvent200Response
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as ComplianceLogSecurityEvent200Response
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/ComplianceLogSecurityEvent200ResponseEvent.md

@@ -0,0 +1,40 @@
+
+# ComplianceLogSecurityEvent200ResponseEvent
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`id` | string
+`eventType` | string
+`severity` | string
+`timestamp` | Date
+
+## Example
+
+```typescript
+import type { ComplianceLogSecurityEvent200ResponseEvent } from 'mudbase-sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "id": null,
+  "eventType": null,
+  "severity": null,
+  "timestamp": null,
+} satisfies ComplianceLogSecurityEvent200ResponseEvent
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as ComplianceLogSecurityEvent200ResponseEvent
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/ComplianceLogSecurityEventRequest.md

@@ -0,0 +1,38 @@
+
+# ComplianceLogSecurityEventRequest
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`eventType` | string
+`severity` | string
+`details` | [ComplianceLogSecurityEventRequestDetails](ComplianceLogSecurityEventRequestDetails.md)
+
+## Example
+
+```typescript
+import type { ComplianceLogSecurityEventRequest } from 'mudbase-sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "eventType": unauthorized_access_attempt,
+  "severity": high,
+  "details": null,
+} satisfies ComplianceLogSecurityEventRequest
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as ComplianceLogSecurityEventRequest
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/ComplianceLogSecurityEventRequestDetails.md

@@ -0,0 +1,44 @@
+
+# ComplianceLogSecurityEventRequestDetails
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`userId` | string
+`resource` | string
+`ipAddress` | string
+`userAgent` | string
+`action` | string
+`reason` | string
+
+## Example
+
+```typescript
+import type { ComplianceLogSecurityEventRequestDetails } from 'mudbase-sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "userId": null,
+  "resource": null,
+  "ipAddress": null,
+  "userAgent": null,
+  "action": null,
+  "reason": null,
+} satisfies ComplianceLogSecurityEventRequestDetails
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as ComplianceLogSecurityEventRequestDetails
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/DataApi.md

@@ -4,21 +4,21 @@ All URIs are relative to *https://cloud.mudbase.dev*
 
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
-| [**createData**](DataApi.md#createdata) | **POST** /api/data/projects/{projectId}/collections/{collectionId}/data | Create data in collection |
-| [**deleteData**](DataApi.md#deletedata) | **DELETE** /api/data/projects/{projectId}/collections/{collectionId}/data/{documentId} | Delete document |
-| [**getData**](DataApi.md#getdata) | **GET** /api/data/projects/{projectId}/collections/{collectionId}/data/{documentId} | Get single document |
-| [**listData**](DataApi.md#listdata) | **GET** /api/data/projects/{projectId}/collections/{collectionId}/data | List data in collection |
-| [**updateData**](DataApi.md#updatedata) | **PATCH** /api/data/projects/{projectId}/collections/{collectionId}/data/{documentId} | Update document |
+| [**dataCreate**](DataApi.md#datacreate) | **POST** /api/data/projects/{projectId}/collections/{collectionId}/data | Create data in collection |
+| [**dataDelete**](DataApi.md#datadelete) | **DELETE** /api/data/projects/{projectId}/collections/{collectionId}/data/{documentId} | Delete document |
+| [**dataGet**](DataApi.md#dataget) | **GET** /api/data/projects/{projectId}/collections/{collectionId}/data/{documentId} | Get single document |
+| [**dataList**](DataApi.md#datalist) | **GET** /api/data/projects/{projectId}/collections/{collectionId}/data | List data in collection |
+| [**dataUpdate**](DataApi.md#dataupdate) | **PATCH** /api/data/projects/{projectId}/collections/{collectionId}/data/{documentId} | Update document |
 
 
 
-## createData
+## dataCreate
 
-> DataResponse createData(projectId, collectionId, body)
+> DataResponse dataCreate(projectId, collectionId, body)
 
 Create data in collection
 
-Create a new document in a collection. Request body must match the collection schema. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+Create a new document in a collection. Request body must match the collection schema. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
 
 ### Example
 
@@ -27,12 +27,12 @@ import {
   Configuration,
   DataApi,
 } from 'mudbase-sdk';
-import type { CreateDataRequest } from 'mudbase-sdk';
+import type { DataCreateRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: ProjectBearerAuth
+    // Configure HTTP bearer authorization: BearerToken
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new DataApi(config);
@@ -44,10 +44,10 @@ async function example() {
     collectionId: collectionId_example,
     // object | Document fields matching the collection schema.
     body: {"email":"john.doe@example.com","firstName":"John","lastName":"Doe","role":"developer","status":"active"},
-  } satisfies CreateDataRequest;
+  } satisfies DataCreateRequest;
 
   try {
-    const data = await api.createData(body);
+    const data = await api.dataCreate(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -73,7 +73,7 @@ example().catch(console.error);
 
 ### Authorization
 
-[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+[BearerToken](../README.md#BearerToken)
 
 ### HTTP request headers
 
@@ -85,20 +85,20 @@ example().catch(console.error);
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 | **201** | Data created |  -  |
-| **400** | Bad request |  -  |
-| **401** | Authentication required |  -  |
-| **403** | Access denied |  -  |
+| **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\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## deleteData
+## dataDelete
 
-> MessageResponse deleteData(projectId, collectionId, documentId)
+> MessageResponse dataDelete(projectId, collectionId, documentId)
 
 Delete document
 
-Delete a document from a collection. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+Delete a document from a collection. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
 
 ### Example
 
@@ -107,12 +107,12 @@ import {
   Configuration,
   DataApi,
 } from 'mudbase-sdk';
-import type { DeleteDataRequest } from 'mudbase-sdk';
+import type { DataDeleteRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: ProjectBearerAuth
+    // Configure HTTP bearer authorization: BearerToken
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new DataApi(config);
@@ -124,10 +124,10 @@ async function example() {
     collectionId: collectionId_example,
     // string | Document ID.
     documentId: documentId_example,
-  } satisfies DeleteDataRequest;
+  } satisfies DataDeleteRequest;
 
   try {
-    const data = await api.deleteData(body);
+    const data = await api.dataDelete(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -153,7 +153,7 @@ example().catch(console.error);
 
 ### Authorization
 
-[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+[BearerToken](../README.md#BearerToken)
 
 ### HTTP request headers
 
@@ -165,20 +165,20 @@ example().catch(console.error);
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 | **200** | Data deleted |  -  |
-| **400** | Bad request |  -  |
-| **401** | Authentication required |  -  |
-| **403** | Access denied |  -  |
+| **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\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## getData
+## dataGet
 
-> DataResponse getData(projectId, collectionId, documentId)
+> DataResponse dataGet(projectId, collectionId, documentId)
 
 Get single document
 
-Get a document by ID from a collection. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+Get a document by ID from a collection. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
 
 ### Example
 
@@ -187,12 +187,12 @@ import {
   Configuration,
   DataApi,
 } from 'mudbase-sdk';
-import type { GetDataRequest } from 'mudbase-sdk';
+import type { DataGetRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: ProjectBearerAuth
+    // Configure HTTP bearer authorization: BearerToken
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new DataApi(config);
@@ -204,10 +204,10 @@ async function example() {
     collectionId: collectionId_example,
     // string | Document ID.
     documentId: documentId_example,
-  } satisfies GetDataRequest;
+  } satisfies DataGetRequest;
 
   try {
-    const data = await api.getData(body);
+    const data = await api.dataGet(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -233,7 +233,7 @@ example().catch(console.error);
 
 ### Authorization
 
-[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+[BearerToken](../README.md#BearerToken)
 
 ### HTTP request headers
 
@@ -245,19 +245,19 @@ example().catch(console.error);
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 | **200** | Document data |  -  |
-| **401** | Authentication required |  -  |
-| **403** | Access denied |  -  |
+| **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\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## listData
+## dataList
 
-> DataListResponse listData(projectId, collectionId, page, limit, sort, filter)
+> DataListResponse dataList(projectId, collectionId, page, limit, sort, filter)
 
 List data in collection
 
-List all documents in a collection with optional pagination, sort, and filter. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+List all documents in a collection with optional pagination, sort, and filter. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
 
 ### Example
 
@@ -266,12 +266,12 @@ import {
   Configuration,
   DataApi,
 } from 'mudbase-sdk';
-import type { ListDataRequest } from 'mudbase-sdk';
+import type { DataListRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: ProjectBearerAuth
+    // Configure HTTP bearer authorization: BearerToken
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new DataApi(config);
@@ -289,10 +289,10 @@ async function example() {
     sort: sort_example,
     // string | JSON string for filtering documents (e.g. {\"status\":\"active\"}). (optional)
     filter: filter_example,
-  } satisfies ListDataRequest;
+  } satisfies DataListRequest;
 
   try {
-    const data = await api.listData(body);
+    const data = await api.dataList(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -321,7 +321,7 @@ example().catch(console.error);
 
 ### Authorization
 
-[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+[BearerToken](../README.md#BearerToken)
 
 ### HTTP request headers
 
@@ -333,19 +333,19 @@ example().catch(console.error);
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 | **200** | Data list |  -  |
-| **401** | Authentication required |  -  |
-| **403** | Access denied |  -  |
+| **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\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## updateData
+## dataUpdate
 
-> DataResponse updateData(projectId, collectionId, documentId, body)
+> DataResponse dataUpdate(projectId, collectionId, documentId, body)
 
 Update document
 
-Update a document in a collection. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+Update a document in a collection. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
 
 ### Example
 
@@ -354,12 +354,12 @@ import {
   Configuration,
   DataApi,
 } from 'mudbase-sdk';
-import type { UpdateDataRequest } from 'mudbase-sdk';
+import type { DataUpdateRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: ProjectBearerAuth
+    // Configure HTTP bearer authorization: BearerToken
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new DataApi(config);
@@ -373,10 +373,10 @@ async function example() {
     documentId: documentId_example,
     // object | Partial document fields to update.
     body: {"firstName":"Sarah","lastName":"Chen","email":"sarah.chen@example.com","role":"admin","status":"active"},
-  } satisfies UpdateDataRequest;
+  } satisfies DataUpdateRequest;
 
   try {
-    const data = await api.updateData(body);
+    const data = await api.dataUpdate(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -403,7 +403,7 @@ example().catch(console.error);
 
 ### Authorization
 
-[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+[BearerToken](../README.md#BearerToken)
 
 ### HTTP request headers
 
@@ -415,9 +415,9 @@ example().catch(console.error);
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 | **200** | Data updated |  -  |
-| **400** | Bad request |  -  |
-| **401** | Authentication required |  -  |
-| **403** | Access denied |  -  |
+| **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\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)