@cloudinary/apps-api 2.2605.49

package/docs/PlatformApi.md

@@ -0,0 +1,915 @@
+# PlatformApi
+
+All URIs are relative to *http://localhost*
+
+| Method | HTTP request | Description |
+|------------- | ------------- | -------------|
+| [**createNamespaceToken**](PlatformApi.md#createnamespacetokenoperation) | **POST** /v2605/platform/apps/storage/namespace-token | Create a namespace token for shared app storage |
+| [**deployApp**](PlatformApi.md#deployapp) | **POST** /v2605/platform/apps/{app_id}/deploy | Deploy a DAM app bundle |
+| [**getApp**](PlatformApi.md#getapp) | **GET** /v2605/platform/apps/{app_id} | Get a DAM app |
+| [**getAppStorageValue**](PlatformApi.md#getappstoragevalue) | **GET** /v2605/platform/apps/storage/{namespace_token}/{level}/{key} | Get a value from app persistent storage |
+| [**getAuthCredentials**](PlatformApi.md#getauthcredentials) | **GET** /v2605/platform/auth/credentials | Get current user and cloud identity |
+| [**getCustomerByCloud**](PlatformApi.md#getcustomerbycloud) | **GET** /v2605/platform/customers/by-cloud/{cloud_name} | Get a customer by cloud name |
+| [**listCustomers**](PlatformApi.md#listcustomers) | **GET** /v2605/platform/customers | List customers (clouds) accessible to the user |
+| [**refreshCloudinaryToken**](PlatformApi.md#refreshcloudinarytoken) | **GET** /v2605/platform/auth/tokens/cloudinary/{type}/refresh | Refresh a Cloudinary token |
+| [**setAppStorageValue**](PlatformApi.md#setappstoragevalueoperation) | **PUT** /v2605/platform/apps/storage/{namespace_token}/{level}/{key} | Set a value in app persistent storage |
+| [**trackAnalyticsEvent**](PlatformApi.md#trackanalyticseventoperation) | **POST** /v2605/platform/analytics | Submit analytics events |
+| [**updateApp**](PlatformApi.md#updateappoperation) | **PUT** /v2605/platform/apps/{app_id} | Update DAM app configuration |
+| [**validateToken**](PlatformApi.md#validatetoken) | **GET** /v2605/platform/auth/tokens/validate | Validate a gateway token |
+
+
+
+## createNamespaceToken
+
+> NamespaceTokenCreateResponse createNamespaceToken(createNamespaceTokenRequest)
+
+Create a namespace token for shared app storage
+
+Mints an encrypted namespace token for app storage. Pass the token as the namespace_token path segment on get/set endpoints. Requires the mint secret.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  PlatformApi,
+} from '@cloudinary/apps-api';
+import type { CreateNamespaceTokenOperationRequest } from '@cloudinary/apps-api';
+
+async function example() {
+  console.log("🚀 Testing @cloudinary/apps-api SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new PlatformApi(config);
+
+  const body = {
+    // CreateNamespaceTokenRequest (optional)
+    createNamespaceTokenRequest: ...,
+  } satisfies CreateNamespaceTokenOperationRequest;
+
+  try {
+    const data = await api.createNamespaceToken(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **createNamespaceTokenRequest** | [CreateNamespaceTokenRequest](CreateNamespaceTokenRequest.md) |  | [Optional] |
+
+### Return type
+
+[**NamespaceTokenCreateResponse**](NamespaceTokenCreateResponse.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Namespace token created |  -  |
+| **403** | Invalid mint secret |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## deployApp
+
+> DeployApp200Response deployApp(appId, bundle, env, version, updateAppUrl)
+
+Deploy a DAM app bundle
+
+deploy a DAM app to https://dam.cloudinary.app/{app_id}/{env}/{version}/ and optionally updates the app\'s appUrl and manifest from cloudinary.app.json in the bundle.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  PlatformApi,
+} from '@cloudinary/apps-api';
+import type { DeployAppRequest } from '@cloudinary/apps-api';
+
+async function example() {
+  console.log("🚀 Testing @cloudinary/apps-api SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new PlatformApi(config);
+
+  const body = {
+    // string | DAM app ID (CustomAction id)
+    appId: appId_example,
+    // Blob | Zip archive of the built app
+    bundle: BINARY_DATA_HERE,
+    // string | Target environment (e.g. development, staging, production)
+    env: env_example,
+    // string | Semver version string, e.g. 1.2.3
+    version: version_example,
+    // string | \\\"true\\\" to update appUrl and manifest (from cloudinary.app.json in the bundle) in dam_apps after successful deploy (optional)
+    updateAppUrl: updateAppUrl_example,
+  } satisfies DeployAppRequest;
+
+  try {
+    const data = await api.deployApp(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **appId** | `string` | DAM app ID (CustomAction id) | [Defaults to `undefined`] |
+| **bundle** | `Blob` | Zip archive of the built app | [Defaults to `undefined`] |
+| **env** | `string` | Target environment (e.g. development, staging, production) | [Defaults to `undefined`] |
+| **version** | `string` | Semver version string, e.g. 1.2.3 | [Defaults to `undefined`] |
+| **updateAppUrl** | `string` | \\\"true\\\" to update appUrl and manifest (from cloudinary.app.json in the bundle) in dam_apps after successful deploy | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**DeployApp200Response**](DeployApp200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `multipart/form-data`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Deploy succeeded |  -  |
+| **207** | Deploy succeeded but appUrl update failed |  -  |
+| **400** | Bad request |  -  |
+| **403** | Not the app owner |  -  |
+| **404** | App not found |  -  |
+| **500** | Deploy failure |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getApp
+
+> DamAppResponse getApp(appId)
+
+Get a DAM app
+
+Returns custom action metadata for a DAM app by ID from the Custom Actions service.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  PlatformApi,
+} from '@cloudinary/apps-api';
+import type { GetAppRequest } from '@cloudinary/apps-api';
+
+async function example() {
+  console.log("🚀 Testing @cloudinary/apps-api SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new PlatformApi(config);
+
+  const body = {
+    // string | DAM app ID (CustomAction id)
+    appId: appId_example,
+  } satisfies GetAppRequest;
+
+  try {
+    const data = await api.getApp(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **appId** | `string` | DAM app ID (CustomAction id) | [Defaults to `undefined`] |
+
+### Return type
+
+[**DamAppResponse**](DamAppResponse.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | DAM app metadata |  -  |
+| **404** | App not found |  -  |
+| **500** | Failed to fetch app |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getAppStorageValue
+
+> AppStorageGetResponse getAppStorageValue(namespaceToken, level, key)
+
+Get a value from app persistent storage
+
+Retrieves a previously stored JSON value by key. Storage is namespaced by a validated namespace_token path segment. Personal level is scoped to the user; shared level is scoped to the customer (cloud). Requires OAuth authentication.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  PlatformApi,
+} from '@cloudinary/apps-api';
+import type { GetAppStorageValueRequest } from '@cloudinary/apps-api';
+
+async function example() {
+  console.log("🚀 Testing @cloudinary/apps-api SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new PlatformApi(config);
+
+  const body = {
+    // string | Encrypted namespace token minted via the namespace-token endpoint
+    namespaceToken: namespaceToken_example,
+    // 'personal' | 'shared' | Storage level: personal (user-scoped) or shared (customer-scoped)
+    level: level_example,
+    // string | User-defined key name
+    key: key_example,
+  } satisfies GetAppStorageValueRequest;
+
+  try {
+    const data = await api.getAppStorageValue(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **namespaceToken** | `string` | Encrypted namespace token minted via the namespace-token endpoint | [Defaults to `undefined`] |
+| **level** | `personal`, `shared` | Storage level: personal (user-scoped) or shared (customer-scoped) | [Defaults to `undefined`] [Enum: personal, shared] |
+| **key** | `string` | User-defined key name | [Defaults to `undefined`] |
+
+### Return type
+
+[**AppStorageGetResponse**](AppStorageGetResponse.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Value retrieved successfully |  -  |
+| **400** | Invalid namespace_token |  -  |
+| **404** | Key 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)
+
+
+## getAuthCredentials
+
+> AuthCredentialsResponse getAuthCredentials()
+
+Get current user and cloud identity
+
+Returns the authenticated user profile and associated customer (cloud) record. Use to confirm session identity and cloud context.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  PlatformApi,
+} from '@cloudinary/apps-api';
+import type { GetAuthCredentialsRequest } from '@cloudinary/apps-api';
+
+async function example() {
+  console.log("🚀 Testing @cloudinary/apps-api SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new PlatformApi(config);
+
+  try {
+    const data = await api.getAuthCredentials();
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**AuthCredentialsResponse**](AuthCredentialsResponse.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Successful authentication response with user identity and permissions |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getCustomerByCloud
+
+> Customer getCustomerByCloud(cloudName)
+
+Get a customer by cloud name
+
+Looks up a specific customer record by its Cloudinary cloud_name. Returns the full customer object or null if not found.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  PlatformApi,
+} from '@cloudinary/apps-api';
+import type { GetCustomerByCloudRequest } from '@cloudinary/apps-api';
+
+async function example() {
+  console.log("🚀 Testing @cloudinary/apps-api SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new PlatformApi(config);
+
+  const body = {
+    // string
+    cloudName: cloudName_example,
+  } satisfies GetCustomerByCloudRequest;
+
+  try {
+    const data = await api.getCustomerByCloud(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **cloudName** | `string` |  | [Defaults to `undefined`] |
+
+### Return type
+
+[**Customer**](Customer.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Successful operation |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## listCustomers
+
+> ListCustomersResponse listCustomers(nameContains, cloudName, product, sortBy, sortOrder)
+
+List customers (clouds) accessible to the user
+
+Returns all Cloudinary customer accounts the authenticated user has access to. Supports filtering by name, cloud_name, and product, with configurable sorting.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  PlatformApi,
+} from '@cloudinary/apps-api';
+import type { ListCustomersRequest } from '@cloudinary/apps-api';
+
+async function example() {
+  console.log("🚀 Testing @cloudinary/apps-api SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new PlatformApi(config);
+
+  const body = {
+    // string (optional)
+    nameContains: nameContains_example,
+    // string (optional)
+    cloudName: cloudName_example,
+    // string (optional)
+    product: product_example,
+    // string (optional)
+    sortBy: sortBy_example,
+    // string (optional)
+    sortOrder: sortOrder_example,
+  } satisfies ListCustomersRequest;
+
+  try {
+    const data = await api.listCustomers(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **nameContains** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **cloudName** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **product** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **sortBy** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **sortOrder** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**ListCustomersResponse**](ListCustomersResponse.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Successful operation |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## refreshCloudinaryToken
+
+> RefreshTokenResponse refreshCloudinaryToken(type)
+
+Refresh a Cloudinary token
+
+Exchanges the current gateway bearer token for a fresh underlying Cloudinary token of the specified type (oauth or console). Returns a 401 and invalidates the session if the token cannot be refreshed.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  PlatformApi,
+} from '@cloudinary/apps-api';
+import type { RefreshCloudinaryTokenRequest } from '@cloudinary/apps-api';
+
+async function example() {
+  console.log("🚀 Testing @cloudinary/apps-api SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new PlatformApi(config);
+
+  const body = {
+    // 'oauth' | 'console'
+    type: type_example,
+  } satisfies RefreshCloudinaryTokenRequest;
+
+  try {
+    const data = await api.refreshCloudinaryToken(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **type** | `oauth`, `console` |  | [Defaults to `undefined`] [Enum: oauth, console] |
+
+### Return type
+
+[**RefreshTokenResponse**](RefreshTokenResponse.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Successful operation |  -  |
+| **401** | Invalid or expired session |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## setAppStorageValue
+
+> AppStorageSetResponse setAppStorageValue(namespaceToken, level, key, setAppStorageValueRequest)
+
+Set a value in app persistent storage
+
+Stores an arbitrary JSON value under the specified key. Storage is namespaced by a validated namespace_token path segment. Personal level: any user can write. Shared level: only admins (master_admin role) can write. Requires OAuth authentication.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  PlatformApi,
+} from '@cloudinary/apps-api';
+import type { SetAppStorageValueOperationRequest } from '@cloudinary/apps-api';
+
+async function example() {
+  console.log("🚀 Testing @cloudinary/apps-api SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new PlatformApi(config);
+
+  const body = {
+    // string | Encrypted namespace token minted via the namespace-token endpoint
+    namespaceToken: namespaceToken_example,
+    // 'personal' | 'shared' | Storage level: personal (user-scoped) or shared (customer-scoped)
+    level: level_example,
+    // string | User-defined key name
+    key: key_example,
+    // SetAppStorageValueRequest (optional)
+    setAppStorageValueRequest: ...,
+  } satisfies SetAppStorageValueOperationRequest;
+
+  try {
+    const data = await api.setAppStorageValue(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **namespaceToken** | `string` | Encrypted namespace token minted via the namespace-token endpoint | [Defaults to `undefined`] |
+| **level** | `personal`, `shared` | Storage level: personal (user-scoped) or shared (customer-scoped) | [Defaults to `undefined`] [Enum: personal, shared] |
+| **key** | `string` | User-defined key name | [Defaults to `undefined`] |
+| **setAppStorageValueRequest** | [SetAppStorageValueRequest](SetAppStorageValueRequest.md) |  | [Optional] |
+
+### Return type
+
+[**AppStorageSetResponse**](AppStorageSetResponse.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Value stored successfully |  -  |
+| **400** | Invalid namespace_token |  -  |
+| **403** | Forbidden - only admins can write to shared storage |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## trackAnalyticsEvent
+
+> AnalyticsResponse trackAnalyticsEvent(trackAnalyticsEventRequest)
+
+Submit analytics events
+
+Accepts a batch of client-side analytics events for server-side processing and forwarding. Each event is an opaque JSON object; the gateway enriches events with IP and user-agent before logging.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  PlatformApi,
+} from '@cloudinary/apps-api';
+import type { TrackAnalyticsEventOperationRequest } from '@cloudinary/apps-api';
+
+async function example() {
+  console.log("🚀 Testing @cloudinary/apps-api SDK...");
+  const api = new PlatformApi();
+
+  const body = {
+    // TrackAnalyticsEventRequest (optional)
+    trackAnalyticsEventRequest: ...,
+  } satisfies TrackAnalyticsEventOperationRequest;
+
+  try {
+    const data = await api.trackAnalyticsEvent(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **trackAnalyticsEventRequest** | [TrackAnalyticsEventRequest](TrackAnalyticsEventRequest.md) |  | [Optional] |
+
+### Return type
+
+[**AnalyticsResponse**](AnalyticsResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Analytics events successfully processed |  -  |
+| **400** | Bad request - invalid event data |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## updateApp
+
+> DamAppResponse updateApp(appId, updateAppRequest)
+
+Update DAM app configuration
+
+Updates app configuration fields for a DAM app. Currently supports appUrl and manifest.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  PlatformApi,
+} from '@cloudinary/apps-api';
+import type { UpdateAppOperationRequest } from '@cloudinary/apps-api';
+
+async function example() {
+  console.log("🚀 Testing @cloudinary/apps-api SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new PlatformApi(config);
+
+  const body = {
+    // string | DAM app ID (CustomAction id)
+    appId: appId_example,
+    // UpdateAppRequest (optional)
+    updateAppRequest: ...,
+  } satisfies UpdateAppOperationRequest;
+
+  try {
+    const data = await api.updateApp(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **appId** | `string` | DAM app ID (CustomAction id) | [Defaults to `undefined`] |
+| **updateAppRequest** | [UpdateAppRequest](UpdateAppRequest.md) |  | [Optional] |
+
+### Return type
+
+[**DamAppResponse**](DamAppResponse.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Updated DAM app metadata |  -  |
+| **400** | Bad request |  -  |
+| **403** | Not the app owner |  -  |
+| **404** | App not found |  -  |
+| **422** | Invalid configuration |  -  |
+| **500** | Update failed |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## validateToken
+
+> ValidateTokenResponse validateToken()
+
+Validate a gateway token
+
+Verifies that the provided API gateway bearer token is well-formed, correctly signed, and not expired. Returns {ok: 1} on success or a 401 error with a descriptive message on failure.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  PlatformApi,
+} from '@cloudinary/apps-api';
+import type { ValidateTokenRequest } from '@cloudinary/apps-api';
+
+async function example() {
+  console.log("🚀 Testing @cloudinary/apps-api SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new PlatformApi(config);
+
+  try {
+    const data = await api.validateToken();
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**ValidateTokenResponse**](ValidateTokenResponse.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Token is valid |  -  |
+| **401** | Invalid or expired token |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+