@cloudinary/apps-api 2.2605.56 → 2.2605.60

package/docs/MediaApi.md

@@ -18,7 +18,7 @@ All URIs are relative to *http://localhost*
 
 ## analyzeAiVisionGeneral
 
-> AiVisionGeneralResponse analyzeAiVisionGeneral(analyzeAiVisionGeneralRequest)
+> AiVisionGeneralResponse analyzeAiVisionGeneral(xCldCloudName, analyzeAiVisionGeneralRequest)
 
 Generate AI Vision analysis (e.g. alt text) for an asset
 
@@ -42,6 +42,8 @@ async function example() {
   const api = new MediaApi(config);
 
   const body = {
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
     // AnalyzeAiVisionGeneralRequest (optional)
     analyzeAiVisionGeneralRequest: ...,
   } satisfies AnalyzeAiVisionGeneralOperationRequest;
@@ -63,6 +65,7 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 | **analyzeAiVisionGeneralRequest** | [AnalyzeAiVisionGeneralRequest](AnalyzeAiVisionGeneralRequest.md) |  | [Optional] |
 
 ### Return type
@@ -89,7 +92,7 @@ example().catch(console.error);
 
 ## createThumbnailToken
 
-> ThumbnailsTokenResponse createThumbnailToken(validFor)
+> ThumbnailsTokenResponse createThumbnailToken(validFor, xCldCloudName)
 
 Generate a time-limited thumbnail access token
 
@@ -115,6 +118,8 @@ async function example() {
   const body = {
     // number (optional)
     validFor: 8.14,
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
   } satisfies CreateThumbnailTokenRequest;
 
   try {
@@ -135,6 +140,7 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **validFor** | `number` |  | [Optional] [Defaults to `undefined`] |
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
@@ -160,7 +166,7 @@ example().catch(console.error);
 
 ## getThumbnail
 
-> string getThumbnail(resourceType, type, version, variant, publicId, token)
+> string getThumbnail(resourceType, type, version, variant, publicId, token, xCldCloudName)
 
 Fetch a rendered thumbnail for an asset
 
@@ -196,6 +202,8 @@ async function example() {
     publicId: publicId_example,
     // string (optional)
     token: token_example,
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
   } satisfies GetThumbnailRequest;
 
   try {
@@ -221,6 +229,7 @@ example().catch(console.error);
 | **variant** | `grid`, `grid_landscape`, `grid_square`, `grid_animated_landscape`, `grid_animated_square`, `preview`, `drilldown`, `template`, `template_primary`, `folder_thumbnail`, `get_info`, `list`, `list_v2`, `square90`, `grid_preview`, `grid_large_preview`, `grid_large_preview_v2`, `asset_picker_grid`, `grid_video_square`, `grid_video_landscape`, `media_editor_widget`, `play_video`, `hls_video_preview`, `video_segment`, `video_stream`, `audio_stream`, `audio_segment` |  | [Defaults to `undefined`] [Enum: grid, grid_landscape, grid_square, grid_animated_landscape, grid_animated_square, preview, drilldown, template, template_primary, folder_thumbnail, get_info, list, list_v2, square90, grid_preview, grid_large_preview, grid_large_preview_v2, asset_picker_grid, grid_video_square, grid_video_landscape, media_editor_widget, play_video, hls_video_preview, video_segment, video_stream, audio_stream, audio_segment] |
 | **publicId** | `string` |  | [Defaults to `undefined`] |
 | **token** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
@@ -309,7 +318,7 @@ No authorization required
 
 ## lookupFont
 
-> FontLookupResponse lookupFont(lookupFontRequest)
+> FontLookupResponse lookupFont(xCldCloudName, lookupFontRequest)
 
 Look up font availability
 
@@ -333,6 +342,8 @@ async function example() {
   const api = new MediaApi(config);
 
   const body = {
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
     // LookupFontRequest (optional)
     lookupFontRequest: ...,
   } satisfies LookupFontOperationRequest;
@@ -354,6 +365,7 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 | **lookupFontRequest** | [LookupFontRequest](LookupFontRequest.md) |  | [Optional] |
 
 ### Return type
@@ -382,7 +394,7 @@ example().catch(console.error);
 
 ## prepareUpload
 
-> PrepareUploadResponse prepareUpload(prepareUploadRequest)
+> PrepareUploadResponse prepareUpload(xCldCloudName, prepareUploadRequest)
 
 Prepare and sign upload parameters
 
@@ -406,6 +418,8 @@ async function example() {
   const api = new MediaApi(config);
 
   const body = {
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
     // PrepareUploadRequest (optional)
     prepareUploadRequest: ...,
   } satisfies PrepareUploadOperationRequest;
@@ -427,6 +441,7 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 | **prepareUploadRequest** | [PrepareUploadRequest](PrepareUploadRequest.md) |  | [Optional] |
 
 ### Return type
@@ -453,7 +468,7 @@ example().catch(console.error);
 
 ## provisionFont
 
-> FontProvisioningResponse provisionFont(provisionFontRequest)
+> FontProvisioningResponse provisionFont(xCldCloudName, provisionFontRequest)
 
 Provision fonts into the cloud
 
@@ -477,6 +492,8 @@ async function example() {
   const api = new MediaApi(config);
 
   const body = {
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
     // ProvisionFontRequest (optional)
     provisionFontRequest: ...,
   } satisfies ProvisionFontOperationRequest;
@@ -498,6 +515,7 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 | **provisionFontRequest** | [ProvisionFontRequest](ProvisionFontRequest.md) |  | [Optional] |
 
 ### Return type
@@ -526,7 +544,7 @@ example().catch(console.error);
 
 ## signAndUpload
 
-> SignAndUploadResponse signAndUpload(file, resourceType, publicId, folder, assetFolder, tags, type, overwrite, invalidate, context, metadata, transformation, format, eager, eagerAsync, eagerNotificationUrl, notificationUrl, displayName, useFilename, uniqueFilename, filenameOverride, accessMode, discardOriginalFilename, phash, async)
+> SignAndUploadResponse signAndUpload(file, xCldCloudName, resourceType, publicId, folder, assetFolder, tags, type, overwrite, invalidate, context, metadata, transformation, format, eager, eagerAsync, eagerNotificationUrl, notificationUrl, displayName, useFilename, uniqueFilename, filenameOverride, accessMode, discardOriginalFilename, phash, async)
 
 Sign and upload an asset in one step
 
@@ -552,6 +570,8 @@ async function example() {
   const body = {
     // Blob | The binary file to upload
     file: BINARY_DATA_HERE,
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
     // string | The type of resource (image, video, raw, auto). Defaults to auto (optional)
     resourceType: resourceType_example,
     // string | Custom public identifier for the uploaded asset (optional)
@@ -620,6 +640,7 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **file** | `Blob` | The binary file to upload | [Defaults to `undefined`] |
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 | **resourceType** | `string` | The type of resource (image, video, raw, auto). Defaults to auto | [Optional] [Defaults to `undefined`] |
 | **publicId** | `string` | Custom public identifier for the uploaded asset | [Optional] [Defaults to `undefined`] |
 | **folder** | `string` | Folder name where the file should be stored | [Optional] [Defaults to `undefined`] |
@@ -669,7 +690,7 @@ example().catch(console.error);
 
 ## uploadAsset
 
-> UploadAssetResponse uploadAsset(resourceType, file, signature, apiKey, timestamp, publicId, folder, tags, type, resourceType2, overwrite, invalidate, context, metadata, transformation, format, eager, async)
+> UploadAssetResponse uploadAsset(resourceType, file, signature, apiKey, xCldCloudName, timestamp, publicId, folder, tags, type, resourceType2, overwrite, invalidate, context, metadata, transformation, format, eager, async)
 
 Upload an asset with a pre-signed signature
 
@@ -701,6 +722,8 @@ async function example() {
     signature: signature_example,
     // string | The API key for authentication
     apiKey: apiKey_example,
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
     // string | Unix timestamp for signature validation (optional)
     timestamp: timestamp_example,
     // string | Custom public identifier for the uploaded asset (optional)
@@ -752,6 +775,7 @@ example().catch(console.error);
 | **file** | `Blob` | The binary file to upload | [Defaults to `undefined`] |
 | **signature** | `string` | The authentication signature for the upload request | [Defaults to `undefined`] |
 | **apiKey** | `string` | The API key for authentication | [Defaults to `undefined`] |
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 | **timestamp** | `string` | Unix timestamp for signature validation | [Optional] [Defaults to `undefined`] |
 | **publicId** | `string` | Custom public identifier for the uploaded asset | [Optional] [Defaults to `undefined`] |
 | **folder** | `string` | Folder name where the file should be stored | [Optional] [Defaults to `undefined`] |

package/docs/PlatformApi.md

@@ -24,7 +24,7 @@ All URIs are relative to *http://localhost*
 
 ## createNamespaceToken
 
-> NamespaceTokenCreateResponse createNamespaceToken(createNamespaceTokenRequest)
+> NamespaceTokenCreateResponse createNamespaceToken(xCldCloudName, createNamespaceTokenRequest)
 
 Create a namespace token for shared app storage
 
@@ -48,6 +48,8 @@ async function example() {
   const api = new PlatformApi(config);
 
   const body = {
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
     // CreateNamespaceTokenRequest (optional)
     createNamespaceTokenRequest: ...,
   } satisfies CreateNamespaceTokenOperationRequest;
@@ -69,6 +71,7 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 | **createNamespaceTokenRequest** | [CreateNamespaceTokenRequest](CreateNamespaceTokenRequest.md) |  | [Optional] |
 
 ### Return type
@@ -96,7 +99,7 @@ example().catch(console.error);
 
 ## deployApp
 
-> DeployApp200Response deployApp(appId, bundle, env, version, updateAppUrl)
+> DeployApp200Response deployApp(appId, bundle, env, version, xCldCloudName, updateAppUrl)
 
 Deploy a DAM app bundle
 
@@ -128,6 +131,8 @@ async function example() {
     env: env_example,
     // string | Semver version string, e.g. 1.2.3
     version: version_example,
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_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;
@@ -153,6 +158,7 @@ example().catch(console.error);
 | **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`] |
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [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
@@ -184,7 +190,7 @@ example().catch(console.error);
 
 ## getApp
 
-> DamAppResponse getApp(appId)
+> DamAppResponse getApp(appId, xCldCloudName)
 
 Get a DAM app
 
@@ -210,6 +216,8 @@ async function example() {
   const body = {
     // string | DAM app ID (CustomAction id)
     appId: appId_example,
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
   } satisfies GetAppRequest;
 
   try {
@@ -230,6 +238,7 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **appId** | `string` | DAM app ID (CustomAction id) | [Defaults to `undefined`] |
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
@@ -257,7 +266,7 @@ example().catch(console.error);
 
 ## getAppStorageValue
 
-> AppStorageGetResponse getAppStorageValue(namespaceToken, level, key)
+> AppStorageGetResponse getAppStorageValue(namespaceToken, level, key, xCldCloudName)
 
 Get a value from app persistent storage
 
@@ -287,6 +296,8 @@ async function example() {
     level: level_example,
     // string | User-defined key name
     key: key_example,
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
   } satisfies GetAppStorageValueRequest;
 
   try {
@@ -309,6 +320,7 @@ example().catch(console.error);
 | **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`] |
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
@@ -336,7 +348,7 @@ example().catch(console.error);
 
 ## getAuthCredentials
 
-> AuthCredentialsResponse getAuthCredentials()
+> AuthCredentialsResponse getAuthCredentials(xCldCloudName)
 
 Get current user and cloud identity
 
@@ -359,8 +371,13 @@ async function example() {
   });
   const api = new PlatformApi(config);
 
+  const body = {
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
+  } satisfies GetAuthCredentialsRequest;
+
   try {
-    const data = await api.getAuthCredentials();
+    const data = await api.getAuthCredentials(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -373,7 +390,10 @@ example().catch(console.error);
 
 ### Parameters
 
-This endpoint does not need any parameter.
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
@@ -399,7 +419,7 @@ This endpoint does not need any parameter.
 
 ## getCustomerByCloud
 
-> Customer getCustomerByCloud(cloudName)
+> Customer getCustomerByCloud(cloudName, xCldCloudName)
 
 Get a customer by cloud name
 
@@ -425,6 +445,8 @@ async function example() {
   const body = {
     // string
     cloudName: cloudName_example,
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
   } satisfies GetCustomerByCloudRequest;
 
   try {
@@ -445,6 +467,7 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **cloudName** | `string` |  | [Defaults to `undefined`] |
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
@@ -470,7 +493,7 @@ example().catch(console.error);
 
 ## getDashboardData
 
-> DashboardDataResponse getDashboardData(variant, timespan, maxResults, sortBy, filters, only)
+> DashboardDataResponse getDashboardData(variant, timespan, maxResults, sortBy, filters, only, xCldCloudName)
 
 Get dashboard report data
 
@@ -506,6 +529,8 @@ async function example() {
     filters: filters_example,
     // string | Trim response attributes (optional)
     only: only_example,
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
   } satisfies GetDashboardDataRequest;
 
   try {
@@ -531,6 +556,7 @@ example().catch(console.error);
 | **sortBy** | `string` | Sort field | [Optional] [Defaults to `undefined`] |
 | **filters** | `string` | Serialized filters | [Optional] [Defaults to `undefined`] |
 | **only** | `string` | Trim response attributes | [Optional] [Defaults to `undefined`] |
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
@@ -557,7 +583,7 @@ example().catch(console.error);
 
 ## listBillingAddons
 
-> ListAddonsResponse listBillingAddons()
+> ListAddonsResponse listBillingAddons(xCldCloudName)
 
 List billing addons
 
@@ -580,8 +606,13 @@ async function example() {
   });
   const api = new PlatformApi(config);
 
+  const body = {
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
+  } satisfies ListBillingAddonsRequest;
+
   try {
-    const data = await api.listBillingAddons();
+    const data = await api.listBillingAddons(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -594,7 +625,10 @@ example().catch(console.error);
 
 ### Parameters
 
-This endpoint does not need any parameter.
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
@@ -621,7 +655,7 @@ This endpoint does not need any parameter.
 
 ## listCustomers
 
-> ListCustomersResponse listCustomers(nameContains, cloudName, product, sortBy, sortOrder)
+> ListCustomersResponse listCustomers(nameContains, cloudName, product, sortBy, sortOrder, xCldCloudName)
 
 List customers (clouds) accessible to the user
 
@@ -655,6 +689,8 @@ async function example() {
     sortBy: sortBy_example,
     // string (optional)
     sortOrder: sortOrder_example,
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
   } satisfies ListCustomersRequest;
 
   try {
@@ -679,6 +715,7 @@ example().catch(console.error);
 | **product** | `string` |  | [Optional] [Defaults to `undefined`] |
 | **sortBy** | `string` |  | [Optional] [Defaults to `undefined`] |
 | **sortOrder** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
@@ -704,7 +741,7 @@ example().catch(console.error);
 
 ## listUsers
 
-> ListUsersResponse listUsers(page, pageSize, sortBy, sortOrder, withDeleted)
+> ListUsersResponse listUsers(page, pageSize, sortBy, sortOrder, withDeleted, xCldCloudName)
 
 List users
 
@@ -738,6 +775,8 @@ async function example() {
     sortOrder: sortOrder_example,
     // boolean | Include deleted users (optional)
     withDeleted: true,
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
   } satisfies ListUsersRequest;
 
   try {
@@ -762,6 +801,7 @@ example().catch(console.error);
 | **sortBy** | `string` | Sort field | [Optional] [Defaults to `undefined`] |
 | **sortOrder** | `string` | Sort direction (asc/desc) | [Optional] [Defaults to `undefined`] |
 | **withDeleted** | `boolean` | Include deleted users | [Optional] [Defaults to `undefined`] |
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
@@ -788,7 +828,7 @@ example().catch(console.error);
 
 ## refreshCloudinaryToken
 
-> RefreshTokenResponse refreshCloudinaryToken(type)
+> RefreshTokenResponse refreshCloudinaryToken(type, xCldCloudName)
 
 Refresh a Cloudinary token
 
@@ -814,6 +854,8 @@ async function example() {
   const body = {
     // 'oauth' | 'console'
     type: type_example,
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
   } satisfies RefreshCloudinaryTokenRequest;
 
   try {
@@ -834,6 +876,7 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **type** | `oauth`, `console` |  | [Defaults to `undefined`] [Enum: oauth, console] |
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
@@ -860,7 +903,7 @@ example().catch(console.error);
 
 ## setAppStorageValue
 
-> AppStorageSetResponse setAppStorageValue(namespaceToken, level, key, setAppStorageValueRequest)
+> AppStorageSetResponse setAppStorageValue(namespaceToken, level, key, xCldCloudName, setAppStorageValueRequest)
 
 Set a value in app persistent storage
 
@@ -890,6 +933,8 @@ async function example() {
     level: level_example,
     // string | User-defined key name
     key: key_example,
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
     // SetAppStorageValueRequest (optional)
     setAppStorageValueRequest: ...,
   } satisfies SetAppStorageValueOperationRequest;
@@ -914,6 +959,7 @@ example().catch(console.error);
 | **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`] |
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 | **setAppStorageValueRequest** | [SetAppStorageValueRequest](SetAppStorageValueRequest.md) |  | [Optional] |
 
 ### Return type
@@ -1011,7 +1057,7 @@ No authorization required
 
 ## updateApp
 
-> DamAppResponse updateApp(appId, updateAppRequest)
+> DamAppResponse updateApp(appId, xCldCloudName, updateAppRequest)
 
 Update DAM app configuration
 
@@ -1037,6 +1083,8 @@ async function example() {
   const body = {
     // string | DAM app ID (CustomAction id)
     appId: appId_example,
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
     // UpdateAppRequest (optional)
     updateAppRequest: ...,
   } satisfies UpdateAppOperationRequest;
@@ -1059,6 +1107,7 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **appId** | `string` | DAM app ID (CustomAction id) | [Defaults to `undefined`] |
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 | **updateAppRequest** | [UpdateAppRequest](UpdateAppRequest.md) |  | [Optional] |
 
 ### Return type
@@ -1090,7 +1139,7 @@ example().catch(console.error);
 
 ## validateToken
 
-> ValidateTokenResponse validateToken()
+> ValidateTokenResponse validateToken(xCldCloudName)
 
 Validate a gateway token
 
@@ -1113,8 +1162,13 @@ async function example() {
   });
   const api = new PlatformApi(config);
 
+  const body = {
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
+  } satisfies ValidateTokenRequest;
+
   try {
-    const data = await api.validateToken();
+    const data = await api.validateToken(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -1127,7 +1181,10 @@ example().catch(console.error);
 
 ### Parameters
 
-This endpoint does not need any parameter.
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 

package/docs/UploadApi.md

@@ -11,7 +11,7 @@ All URIs are relative to *http://localhost*
 
 ## deprecatedPostCloudinaryUploadCloudNameResourceTypeTags
 
-> UpdateAssetTagsResponse deprecatedPostCloudinaryUploadCloudNameResourceTypeTags(cloudName, resourceType, updateAssetTagsRequest)
+> UpdateAssetTagsResponse deprecatedPostCloudinaryUploadCloudNameResourceTypeTags(cloudName, resourceType, xCldCloudName, updateAssetTagsRequest)
 
 
 
@@ -37,6 +37,8 @@ async function example() {
     cloudName: cloudName_example,
     // string | The resource type (e.g., image, video, raw)
     resourceType: resourceType_example,
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
     // UpdateAssetTagsRequest (optional)
     updateAssetTagsRequest: ...,
   } satisfies DeprecatedPostCloudinaryUploadCloudNameResourceTypeTagsRequest;
@@ -60,6 +62,7 @@ example().catch(console.error);
 |------------- | ------------- | ------------- | -------------|
 | **cloudName** | `string` |  | [Defaults to `undefined`] |
 | **resourceType** | `string` | The resource type (e.g., image, video, raw) | [Defaults to `undefined`] |
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 | **updateAssetTagsRequest** | [UpdateAssetTagsRequest](UpdateAssetTagsRequest.md) |  | [Optional] |
 
 ### Return type
@@ -86,7 +89,7 @@ example().catch(console.error);
 
 ## deprecatedPostCloudinaryUploadCloudNameResourceTypeUpload
 
-> UploadAssetResponse deprecatedPostCloudinaryUploadCloudNameResourceTypeUpload(cloudName, resourceType, file, signature, apiKey, timestamp, publicId, folder, tags, type, resourceType2, overwrite, invalidate, context, metadata, transformation, format, eager, async)
+> UploadAssetResponse deprecatedPostCloudinaryUploadCloudNameResourceTypeUpload(cloudName, resourceType, file, signature, apiKey, xCldCloudName, timestamp, publicId, folder, tags, type, resourceType2, overwrite, invalidate, context, metadata, transformation, format, eager, async)
 
 Upload an asset to Cloudinary
 
@@ -120,6 +123,8 @@ async function example() {
     signature: signature_example,
     // string | The API key for authentication
     apiKey: apiKey_example,
+    // string | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. (optional)
+    xCldCloudName: xCldCloudName_example,
     // string | Unix timestamp for signature validation (optional)
     timestamp: timestamp_example,
     // string | Custom public identifier for the uploaded asset (optional)
@@ -172,6 +177,7 @@ example().catch(console.error);
 | **file** | `Blob` | The binary file to upload | [Defaults to `undefined`] |
 | **signature** | `string` | The authentication signature for the upload request | [Defaults to `undefined`] |
 | **apiKey** | `string` | The API key for authentication | [Defaults to `undefined`] |
+| **xCldCloudName** | `string` | Target Cloudinary cloud name. Required when using an account-level token that is not scoped to a cloud. This header, the request subdomain, and the token\'s own cloud must match wherever more than one is present — no source overrides another, and any disagreement is rejected with 400. | [Optional] [Defaults to `undefined`] |
 | **timestamp** | `string` | Unix timestamp for signature validation | [Optional] [Defaults to `undefined`] |
 | **publicId** | `string` | Custom public identifier for the uploaded asset | [Optional] [Defaults to `undefined`] |
 | **folder** | `string` | Folder name where the file should be stored | [Optional] [Defaults to `undefined`] |