@cloudinary/apps-api 2.2605.58 → 2.2605.60

package/docs/UtilsApi.md

@@ -19,7 +19,7 @@ All URIs are relative to *http://localhost*
 
 ## deprecatedGetUtilsAppStorageNamespaceTokenLevelKey
 
-> AppStorageGetResponse deprecatedGetUtilsAppStorageNamespaceTokenLevelKey(namespaceToken, level, key)
+> AppStorageGetResponse deprecatedGetUtilsAppStorageNamespaceTokenLevelKey(namespaceToken, level, key, xCldCloudName)
 
 Get persistent storage value
 
@@ -49,6 +49,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 DeprecatedGetUtilsAppStorageNamespaceTokenLevelKeyRequest;
 
   try {
@@ -71,6 +73,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
 
@@ -98,7 +101,7 @@ example().catch(console.error);
 
 ## deprecatedGetUtilsAuthCloudinaryTokenTypeRefresh
 
-> RefreshTokenResponse deprecatedGetUtilsAuthCloudinaryTokenTypeRefresh(type)
+> RefreshTokenResponse deprecatedGetUtilsAuthCloudinaryTokenTypeRefresh(type, xCldCloudName)
 
 res console
 
@@ -124,6 +127,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 DeprecatedGetUtilsAuthCloudinaryTokenTypeRefreshRequest;
 
   try {
@@ -144,6 +149,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
 
@@ -170,7 +176,7 @@ example().catch(console.error);
 
 ## deprecatedGetUtilsBackreferenceAssetAssetId
 
-> ListBackreferencesResponse deprecatedGetUtilsBackreferenceAssetAssetId(assetId, system, tenant, includeRemoved)
+> ListBackreferencesResponse deprecatedGetUtilsBackreferenceAssetAssetId(assetId, system, tenant, includeRemoved, xCldCloudName)
 
 List asset backreferences
 
@@ -202,6 +208,8 @@ async function example() {
     tenant: tenant_example,
     // boolean | Include backreferences whose current action is remove (optional)
     includeRemoved: 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 DeprecatedGetUtilsBackreferenceAssetAssetIdRequest;
 
   try {
@@ -225,6 +233,7 @@ example().catch(console.error);
 | **system** | `string` | Filter by system name (e.g., \'monday\') | [Optional] [Defaults to `undefined`] |
 | **tenant** | `string` | Filter by tenant/workspace ID (requires system) | [Optional] [Defaults to `undefined`] |
 | **includeRemoved** | `boolean` | Include backreferences whose current action is remove | [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
 
@@ -312,7 +321,7 @@ No authorization required
 
 ## deprecatedGetUtilsValidateToken
 
-> ValidateTokenResponse deprecatedGetUtilsValidateToken()
+> ValidateTokenResponse deprecatedGetUtilsValidateToken(xCldCloudName)
 
 validate JWT token
 
@@ -335,8 +344,13 @@ async function example() {
   });
   const api = new UtilsApi(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 DeprecatedGetUtilsValidateTokenRequest;
+
   try {
-    const data = await api.deprecatedGetUtilsValidateToken();
+    const data = await api.deprecatedGetUtilsValidateToken(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -349,7 +363,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
 
@@ -445,7 +462,7 @@ No authorization required
 
 ## deprecatedPostUtilsBackreferenceAsset
 
-> UpdateBackreferencesResponse deprecatedPostUtilsBackreferenceAsset(updateAssetBackreferencesRequest)
+> UpdateBackreferencesResponse deprecatedPostUtilsBackreferenceAsset(xCldCloudName, updateAssetBackreferencesRequest)
 
 Manage asset backreferences
 
@@ -469,6 +486,8 @@ async function example() {
   const api = new UtilsApi(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,
     // UpdateAssetBackreferencesRequest (optional)
     updateAssetBackreferencesRequest: ...,
   } satisfies DeprecatedPostUtilsBackreferenceAssetRequest;
@@ -490,6 +509,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`] |
 | **updateAssetBackreferencesRequest** | [UpdateAssetBackreferencesRequest](UpdateAssetBackreferencesRequest.md) |  | [Optional] |
 
 ### Return type
@@ -518,7 +538,7 @@ example().catch(console.error);
 
 ## deprecatedPostUtilsFontsLookup
 
-> FontLookupResponse deprecatedPostUtilsFontsLookup(lookupFontRequest)
+> FontLookupResponse deprecatedPostUtilsFontsLookup(xCldCloudName, lookupFontRequest)
 
 lookup fonts
 
@@ -542,6 +562,8 @@ async function example() {
   const api = new UtilsApi(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 DeprecatedPostUtilsFontsLookupRequest;
@@ -563,6 +585,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
@@ -591,7 +614,7 @@ example().catch(console.error);
 
 ## deprecatedPostUtilsFontsProvision
 
-> FontProvisioningResponse deprecatedPostUtilsFontsProvision(provisionFontRequest)
+> FontProvisioningResponse deprecatedPostUtilsFontsProvision(xCldCloudName, provisionFontRequest)
 
 lookup fonts
 
@@ -615,6 +638,8 @@ async function example() {
   const api = new UtilsApi(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 DeprecatedPostUtilsFontsProvisionRequest;
@@ -636,6 +661,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
@@ -664,7 +690,7 @@ example().catch(console.error);
 
 ## deprecatedPutUtilsAppStorageNamespaceTokenLevelKey
 
-> AppStorageSetResponse deprecatedPutUtilsAppStorageNamespaceTokenLevelKey(namespaceToken, level, key, setAppStorageValueRequest)
+> AppStorageSetResponse deprecatedPutUtilsAppStorageNamespaceTokenLevelKey(namespaceToken, level, key, xCldCloudName, setAppStorageValueRequest)
 
 Set persistent storage value
 
@@ -694,6 +720,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 DeprecatedPutUtilsAppStorageNamespaceTokenLevelKeyRequest;
@@ -718,6 +746,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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudinary/apps-api",
-  "version": "2.2605.58",
+  "version": "2.2605.60",
   "description": "OpenAPI client for @cloudinary/apps-api",
   "author": "OpenAPI-Generator",
   "main": "./dist/index.js",