@cloudinary/apps-api 2.2605.49

package/docs/AssetManagementApi.md

@@ -0,0 +1,2029 @@
+# AssetManagementApi
+
+All URIs are relative to *http://localhost*
+
+| Method | HTTP request | Description |
+|------------- | ------------- | -------------|
+| [**addCollectionAssets**](AssetManagementApi.md#addcollectionassetsoperation) | **POST** /v2605/asset-management/collections/{collection_id}/assets | Add assets to a collection |
+| [**autocompleteAssets**](AssetManagementApi.md#autocompleteassets) | **GET** /v2605/asset-management/assets/autocomplete | Autocomplete across assets, folders, collections, tags, and metadata |
+| [**createAssetMetadataField**](AssetManagementApi.md#createassetmetadatafieldoperation) | **POST** /v2605/asset-management/assets/metadata/fields | Create a structured metadata field definition |
+| [**createCollection**](AssetManagementApi.md#createcollectionoperation) | **POST** /v2605/asset-management/collections | Create a collection |
+| [**createFolder**](AssetManagementApi.md#createfolderoperation) | **POST** /v2605/asset-management/folders | Create a folder |
+| [**deleteFolder**](AssetManagementApi.md#deletefolder) | **DELETE** /v2605/asset-management/folders/{id} | Delete a folder |
+| [**destroyCollection**](AssetManagementApi.md#destroycollection) | **DELETE** /v2605/asset-management/collections/{collection_id} | Delete a collection |
+| [**downloadAsset**](AssetManagementApi.md#downloadassetoperation) | **POST** /v2605/asset-management/assets/download | Generate a download URL for an asset |
+| [**downloadCollection**](AssetManagementApi.md#downloadcollection) | **POST** /v2605/asset-management/collections/{collection_id}/download | Download a collection as an archive |
+| [**listAssetBackreferences**](AssetManagementApi.md#listassetbackreferences) | **GET** /v2605/asset-management/backreferences/assets/{assetId} | List backreferences for an asset |
+| [**listAssetContextFields**](AssetManagementApi.md#listassetcontextfields) | **GET** /v2605/asset-management/assets/metadata/context-fields | List contextual metadata fields |
+| [**listAssetHistory**](AssetManagementApi.md#listassethistory) | **GET** /v2605/asset-management/assets/{external_id}/asset-history | List asset audit history |
+| [**listAssetMetadataFields**](AssetManagementApi.md#listassetmetadatafields) | **GET** /v2605/asset-management/assets/metadata/fields | List structured metadata field definitions |
+| [**listAssetsByFolder**](AssetManagementApi.md#listassetsbyfolder) | **GET** /v2605/asset-management/assets/by-folder | List assets in a folder |
+| [**listCollections**](AssetManagementApi.md#listcollections) | **GET** /v2605/asset-management/collections | List collections |
+| [**listSubfolders**](AssetManagementApi.md#listsubfolders) | **GET** /v2605/asset-management/folders/subfolders | List child folders |
+| [**listTransformations**](AssetManagementApi.md#listtransformations) | **GET** /v2605/asset-management/transformations | List named transformations |
+| [**removeCollectionAssets**](AssetManagementApi.md#removecollectionassetsoperation) | **DELETE** /v2605/asset-management/collections/{collection_id}/assets | Remove assets from a collection |
+| [**searchAssets**](AssetManagementApi.md#searchassets) | **POST** /v2605/asset-management/assets/search | Search assets using Cloudinary expression language |
+| [**searchCollections**](AssetManagementApi.md#searchcollectionsoperation) | **POST** /v2605/asset-management/collections/search | Search collections |
+| [**searchTemplates**](AssetManagementApi.md#searchtemplates) | **GET** /v2605/asset-management/templates | Search creative automation templates |
+| [**showCollection**](AssetManagementApi.md#showcollection) | **GET** /v2605/asset-management/collections/{collection_id} | Get a single collection with its assets |
+| [**updateAssetBackreferences**](AssetManagementApi.md#updateassetbackreferencesoperation) | **POST** /v2605/asset-management/backreferences/assets | Create, update, or remove asset backreferences |
+| [**updateAssetMetadata**](AssetManagementApi.md#updateassetmetadataoperation) | **PATCH** /v2605/asset-management/assets/metadata | Update asset contextual and structured metadata |
+| [**updateAssetTags**](AssetManagementApi.md#updateassettagsoperation) | **POST** /v2605/asset-management/assets/{resource_type}/tags | Add or remove a tag on assets |
+| [**updateCollection**](AssetManagementApi.md#updatecollectionoperation) | **PUT** /v2605/asset-management/collections/{collection_id} | Update a collection |
+
+
+
+## addCollectionAssets
+
+> AddCollectionAssetsResponse addCollectionAssets(collectionId, addCollectionAssetsRequest)
+
+Add assets to a collection
+
+Adds one or more assets to an existing collection by resource_ids or external_ids. Caller must have write access to both the collection and the assets.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { AddCollectionAssetsOperationRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // string | Collection external ID
+    collectionId: collectionId_example,
+    // AddCollectionAssetsRequest (optional)
+    addCollectionAssetsRequest: ...,
+  } satisfies AddCollectionAssetsOperationRequest;
+
+  try {
+    const data = await api.addCollectionAssets(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **collectionId** | `string` | Collection external ID | [Defaults to `undefined`] |
+| **addCollectionAssetsRequest** | [AddCollectionAssetsRequest](AddCollectionAssetsRequest.md) |  | [Optional] |
+
+### Return type
+
+[**AddCollectionAssetsResponse**](AddCollectionAssetsResponse.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** | Successful operation |  -  |
+| **403** | Forbidden |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## autocompleteAssets
+
+> AutocompleteResponse autocompleteAssets(term, resourceType, assets, collections, folders, tags, users, withDeletedUsers, userGroups, metadataFieldOptions)
+
+Autocomplete across assets, folders, collections, tags, and metadata
+
+Returns typeahead suggestions for a search term across multiple entity types. Each type param (assets, folders, tags, etc.) controls the max results returned for that category; omit a param to exclude that category.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { AutocompleteAssetsRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // string
+    term: term_example,
+    // 'image' | 'javascript' | 'css' | 'video' | 'raw' | 'any' (optional)
+    resourceType: resourceType_example,
+    // number (optional)
+    assets: 56,
+    // number (optional)
+    collections: 56,
+    // number (optional)
+    folders: 56,
+    // number (optional)
+    tags: 56,
+    // number (optional)
+    users: 56,
+    // boolean (optional)
+    withDeletedUsers: true,
+    // number (optional)
+    userGroups: 56,
+    // number (optional)
+    metadataFieldOptions: 56,
+  } satisfies AutocompleteAssetsRequest;
+
+  try {
+    const data = await api.autocompleteAssets(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **term** | `string` |  | [Defaults to `undefined`] |
+| **resourceType** | `image`, `javascript`, `css`, `video`, `raw`, `any` |  | [Optional] [Defaults to `undefined`] [Enum: image, javascript, css, video, raw, any] |
+| **assets** | `number` |  | [Optional] [Defaults to `undefined`] |
+| **collections** | `number` |  | [Optional] [Defaults to `undefined`] |
+| **folders** | `number` |  | [Optional] [Defaults to `undefined`] |
+| **tags** | `number` |  | [Optional] [Defaults to `undefined`] |
+| **users** | `number` |  | [Optional] [Defaults to `undefined`] |
+| **withDeletedUsers** | `boolean` |  | [Optional] [Defaults to `undefined`] |
+| **userGroups** | `number` |  | [Optional] [Defaults to `undefined`] |
+| **metadataFieldOptions** | `number` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**AutocompleteResponse**](AutocompleteResponse.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)
+
+
+## createAssetMetadataField
+
+> CreateMetadataFieldResponse createAssetMetadataField(createAssetMetadataFieldRequest)
+
+Create a structured metadata field definition
+
+Idempotently creates a structured metadata field for the cloud. Returns already_exists=true if a field with the given external_id is already defined.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { CreateAssetMetadataFieldOperationRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // CreateAssetMetadataFieldRequest (optional)
+    createAssetMetadataFieldRequest: ...,
+  } satisfies CreateAssetMetadataFieldOperationRequest;
+
+  try {
+    const data = await api.createAssetMetadataField(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **createAssetMetadataFieldRequest** | [CreateAssetMetadataFieldRequest](CreateAssetMetadataFieldRequest.md) |  | [Optional] |
+
+### Return type
+
+[**CreateMetadataFieldResponse**](CreateMetadataFieldResponse.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** | Field created or already exists |  -  |
+| **400** | Bad request - invalid field definition |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## createCollection
+
+> CreateCollectionResponse createCollection(createCollectionRequest)
+
+Create a collection
+
+Creates a new collection (classic, dynamic, or temp). Dynamic collections auto-populate based on dynamic_filters; classic collections are manually curated.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { CreateCollectionOperationRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // CreateCollectionRequest (optional)
+    createCollectionRequest: ...,
+  } satisfies CreateCollectionOperationRequest;
+
+  try {
+    const data = await api.createCollection(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **createCollectionRequest** | [CreateCollectionRequest](CreateCollectionRequest.md) |  | [Optional] |
+
+### Return type
+
+[**CreateCollectionResponse**](CreateCollectionResponse.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** | Successful operation |  -  |
+| **403** | Forbidden |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## createFolder
+
+> CreateFolderResponse createFolder(createFolderRequest)
+
+Create a folder
+
+Creates a new subfolder under the specified parent_id, or under the root folder when parent_id is omitted.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { CreateFolderOperationRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // CreateFolderRequest (optional)
+    createFolderRequest: ...,
+  } satisfies CreateFolderOperationRequest;
+
+  try {
+    const data = await api.createFolder(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **createFolderRequest** | [CreateFolderRequest](CreateFolderRequest.md) |  | [Optional] |
+
+### Return type
+
+[**CreateFolderResponse**](CreateFolderResponse.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** | 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)
+
+
+## deleteFolder
+
+> DeleteFolderResponse deleteFolder(id, deleteResources)
+
+Delete a folder
+
+Deletes a folder by its external ID. The upstream Console API rejects deletion when the folder still contains assets.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { DeleteFolderRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // string
+    id: id_example,
+    // boolean (optional)
+    deleteResources: true,
+  } satisfies DeleteFolderRequest;
+
+  try {
+    const data = await api.deleteFolder(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **id** | `string` |  | [Defaults to `undefined`] |
+| **deleteResources** | `boolean` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**DeleteFolderResponse**](DeleteFolderResponse.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)
+
+
+## destroyCollection
+
+> Collection destroyCollection(collectionId)
+
+Delete a collection
+
+Soft-deletes a collection. The collection\'s assets are not removed from the cloud. Caller must have write access.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { DestroyCollectionRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // string | Collection external ID
+    collectionId: collectionId_example,
+  } satisfies DestroyCollectionRequest;
+
+  try {
+    const data = await api.destroyCollection(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **collectionId** | `string` | Collection external ID | [Defaults to `undefined`] |
+
+### Return type
+
+[**Collection**](Collection.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 |  -  |
+| **403** | Forbidden |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## downloadAsset
+
+> DownloadAssetResponse downloadAsset(downloadAssetRequest)
+
+Generate a download URL for an asset
+
+Returns a time-limited redirect URL for downloading an asset. Accepts external_id directly, or resolves public_id to external_id via search. Optionally applies a transformation before download.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { DownloadAssetOperationRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // DownloadAssetRequest (optional)
+    downloadAssetRequest: ...,
+  } satisfies DownloadAssetOperationRequest;
+
+  try {
+    const data = await api.downloadAsset(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **downloadAssetRequest** | [DownloadAssetRequest](DownloadAssetRequest.md) |  | [Optional] |
+
+### Return type
+
+[**DownloadAssetResponse**](DownloadAssetResponse.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** | Successful download response with URL |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## downloadCollection
+
+> DownloadCollectionResponse downloadCollection(collectionId, targetPublicId, redirect)
+
+Download a collection as an archive
+
+Generates a ZIP archive containing all assets in the collection. Returns an archive URL or redirects to it depending on the redirect parameter.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { DownloadCollectionRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // string | Collection external ID
+    collectionId: collectionId_example,
+    // string | Target public ID for the archive (optional)
+    targetPublicId: targetPublicId_example,
+    // boolean | Whether to redirect to the archive URL (optional)
+    redirect: true,
+  } satisfies DownloadCollectionRequest;
+
+  try {
+    const data = await api.downloadCollection(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **collectionId** | `string` | Collection external ID | [Defaults to `undefined`] |
+| **targetPublicId** | `string` | Target public ID for the archive | [Optional] [Defaults to `undefined`] |
+| **redirect** | `boolean` | Whether to redirect to the archive URL | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**DownloadCollectionResponse**](DownloadCollectionResponse.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 |  -  |
+| **403** | Forbidden |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## listAssetBackreferences
+
+> ListBackreferencesResponse listAssetBackreferences(assetId, system, tenant, includeRemoved)
+
+List backreferences for an asset
+
+Returns active backreference entries recorded on an asset. Optionally filter by system and/or tenant. Pass includeRemoved=true to include removed links. Context search matches ever-associated ref URIs; list reflects current link state.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { ListAssetBackreferencesRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // string | Cloudinary asset id
+    assetId: assetId_example,
+    // string | Filter by system name (e.g., \'monday\') (optional)
+    system: system_example,
+    // string | Filter by tenant/workspace ID (requires system) (optional)
+    tenant: tenant_example,
+    // boolean | Include backreferences whose current action is remove (optional)
+    includeRemoved: true,
+  } satisfies ListAssetBackreferencesRequest;
+
+  try {
+    const data = await api.listAssetBackreferences(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **assetId** | `string` | Cloudinary asset id | [Defaults to `undefined`] |
+| **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`] |
+
+### Return type
+
+[**ListBackreferencesResponse**](ListBackreferencesResponse.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 |  -  |
+| **404** | Asset 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)
+
+
+## listAssetContextFields
+
+> ListContextualMetadataFieldsResponse listAssetContextFields(maxResults, nextCursor, prefix)
+
+List contextual metadata fields
+
+Returns contextual metadata keys in use across assets in the cloud. Unlike structured metadata fields, contextual fields are simple key-value pairs without type definitions.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { ListAssetContextFieldsRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // number (optional)
+    maxResults: 56,
+    // string (optional)
+    nextCursor: nextCursor_example,
+    // string (optional)
+    prefix: prefix_example,
+  } satisfies ListAssetContextFieldsRequest;
+
+  try {
+    const data = await api.listAssetContextFields(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **maxResults** | `number` |  | [Optional] [Defaults to `50`] |
+| **nextCursor** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **prefix** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**ListContextualMetadataFieldsResponse**](ListContextualMetadataFieldsResponse.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)
+
+
+## listAssetHistory
+
+> AssetHistoryResponse listAssetHistory(externalId, maxResults, nextCursor)
+
+List asset audit history
+
+Returns paginated audit history for an asset identified by external_id, including metadata updates, downloads, version changes, and deletions.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { ListAssetHistoryRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // string | Asset external ID
+    externalId: externalId_example,
+    // number | Maximum number of history entries to return (optional)
+    maxResults: 8.14,
+    // number | Pagination cursor (optional)
+    nextCursor: 8.14,
+  } satisfies ListAssetHistoryRequest;
+
+  try {
+    const data = await api.listAssetHistory(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **externalId** | `string` | Asset external ID | [Defaults to `undefined`] |
+| **maxResults** | `number` | Maximum number of history entries to return | [Optional] [Defaults to `undefined`] |
+| **nextCursor** | `number` | Pagination cursor | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**AssetHistoryResponse**](AssetHistoryResponse.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)
+
+
+## listAssetMetadataFields
+
+> ListMetadataFieldsResponse listAssetMetadataFields()
+
+List structured metadata field definitions
+
+Returns all structured metadata field definitions configured for the cloud, including field type, label, validation rules, and datasource.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { ListAssetMetadataFieldsRequest } 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 AssetManagementApi(config);
+
+  try {
+    const data = await api.listAssetMetadataFields();
+    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
+
+[**ListMetadataFieldsResponse**](ListMetadataFieldsResponse.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)
+
+
+## listAssetsByFolder
+
+> ListAssetsByFolderResponse listAssetsByFolder(folderId, resourceType, sortBy, maxResults, nextCursor)
+
+List assets in a folder
+
+Returns assets within a folder identified by folder_id, with optional resource_type filter, sorting, and cursor-based pagination.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { ListAssetsByFolderRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // string (optional)
+    folderId: folderId_example,
+    // 'image' | 'javascript' | 'css' | 'video' | 'raw' | 'any' (optional)
+    resourceType: resourceType_example,
+    // string (optional)
+    sortBy: sortBy_example,
+    // number (optional)
+    maxResults: 56,
+    // string (optional)
+    nextCursor: nextCursor_example,
+  } satisfies ListAssetsByFolderRequest;
+
+  try {
+    const data = await api.listAssetsByFolder(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **folderId** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **resourceType** | `image`, `javascript`, `css`, `video`, `raw`, `any` |  | [Optional] [Defaults to `undefined`] [Enum: image, javascript, css, video, raw, any] |
+| **sortBy** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **maxResults** | `number` |  | [Optional] [Defaults to `undefined`] |
+| **nextCursor** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**ListAssetsByFolderResponse**](ListAssetsByFolderResponse.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)
+
+
+## listCollections
+
+> ListCollectionsResponse listCollections(sortBy, maxResults, nextCursor, term, ownerType)
+
+List collections
+
+Returns all collections accessible to the caller, with optional term filter, owner_type filter, sorting, and cursor-based pagination.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { ListCollectionsRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // string | Sort field (optional)
+    sortBy: sortBy_example,
+    // number | Maximum number of results (optional)
+    maxResults: 8.14,
+    // string | Pagination cursor (optional)
+    nextCursor: nextCursor_example,
+    // string | Search term (optional)
+    term: term_example,
+    // string | Filter by owner type (optional)
+    ownerType: ownerType_example,
+  } satisfies ListCollectionsRequest;
+
+  try {
+    const data = await api.listCollections(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **sortBy** | `string` | Sort field | [Optional] [Defaults to `undefined`] |
+| **maxResults** | `number` | Maximum number of results | [Optional] [Defaults to `undefined`] |
+| **nextCursor** | `string` | Pagination cursor | [Optional] [Defaults to `undefined`] |
+| **term** | `string` | Search term | [Optional] [Defaults to `undefined`] |
+| **ownerType** | `string` | Filter by owner type | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**ListCollectionsResponse**](ListCollectionsResponse.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 |  -  |
+| **403** | Forbidden |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## listSubfolders
+
+> ListSubfoldersResponse listSubfolders(parentPath, externalId, maxResults, nextCursor)
+
+List child folders
+
+Returns immediate subfolders of a given parent path or folder external ID, with pagination support.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { ListSubfoldersRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // string (optional)
+    parentPath: parentPath_example,
+    // string (optional)
+    externalId: externalId_example,
+    // number (optional)
+    maxResults: 56,
+    // string (optional)
+    nextCursor: nextCursor_example,
+  } satisfies ListSubfoldersRequest;
+
+  try {
+    const data = await api.listSubfolders(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **parentPath** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **externalId** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **maxResults** | `number` |  | [Optional] [Defaults to `undefined`] |
+| **nextCursor** | `string` |  | [Optional] [Defaults to `''`] |
+
+### Return type
+
+[**ListSubfoldersResponse**](ListSubfoldersResponse.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)
+
+
+## listTransformations
+
+> ListTransformationsResponse listTransformations(maxResults, nextCursor, name)
+
+List named transformations
+
+Returns named transformations defined in the cloud. Supports pagination via next_cursor and optional client-side name filtering.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { ListTransformationsRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // number (optional)
+    maxResults: 56,
+    // string (optional)
+    nextCursor: nextCursor_example,
+    // string (optional)
+    name: name_example,
+  } satisfies ListTransformationsRequest;
+
+  try {
+    const data = await api.listTransformations(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **maxResults** | `number` |  | [Optional] [Defaults to `undefined`] |
+| **nextCursor** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **name** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**ListTransformationsResponse**](ListTransformationsResponse.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)
+
+
+## removeCollectionAssets
+
+> RemoveCollectionAssetsResponse removeCollectionAssets(collectionId, removeCollectionAssetsRequest)
+
+Remove assets from a collection
+
+Removes one or more assets from a collection by resource_ids or external_ids. The assets themselves are not deleted.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { RemoveCollectionAssetsOperationRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // string | Collection external ID
+    collectionId: collectionId_example,
+    // RemoveCollectionAssetsRequest (optional)
+    removeCollectionAssetsRequest: ...,
+  } satisfies RemoveCollectionAssetsOperationRequest;
+
+  try {
+    const data = await api.removeCollectionAssets(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **collectionId** | `string` | Collection external ID | [Defaults to `undefined`] |
+| **removeCollectionAssetsRequest** | [RemoveCollectionAssetsRequest](RemoveCollectionAssetsRequest.md) |  | [Optional] |
+
+### Return type
+
+[**RemoveCollectionAssetsResponse**](RemoveCollectionAssetsResponse.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** | Successful operation |  -  |
+| **403** | Forbidden |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## searchAssets
+
+> AssetSearchResponse searchAssets(expression, maxResults, nextCursor, sortBy, backend, aggregate)
+
+Search assets using Cloudinary expression language
+
+Full-text and field-scoped search over all assets in the cloud. Supports pagination via next_cursor, sort ordering, backend selection (relational, elastic, CLIP), and field aggregations.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { SearchAssetsRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // string
+    expression: expression_example,
+    // number (optional)
+    maxResults: 56,
+    // string (optional)
+    nextCursor: nextCursor_example,
+    // string (optional)
+    sortBy: sortBy_example,
+    // 'relational' | 'elastic' | 'clip' | 'clip_text' | 'clip_url' (optional)
+    backend: backend_example,
+    // string (optional)
+    aggregate: aggregate_example,
+  } satisfies SearchAssetsRequest;
+
+  try {
+    const data = await api.searchAssets(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **expression** | `string` |  | [Defaults to `undefined`] |
+| **maxResults** | `number` |  | [Optional] [Defaults to `undefined`] |
+| **nextCursor** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **sortBy** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **backend** | `relational`, `elastic`, `clip`, `clip_text`, `clip_url` |  | [Optional] [Defaults to `undefined`] [Enum: relational, elastic, clip, clip_text, clip_url] |
+| **aggregate** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**AssetSearchResponse**](AssetSearchResponse.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)
+
+
+## searchCollections
+
+> SearchCollectionsResponse searchCollections(searchCollectionsRequest)
+
+Search collections
+
+Search collections by term with configurable sort order, pagination, and owner_type filtering. Query is sent in the request body.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { SearchCollectionsOperationRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // SearchCollectionsRequest (optional)
+    searchCollectionsRequest: ...,
+  } satisfies SearchCollectionsOperationRequest;
+
+  try {
+    const data = await api.searchCollections(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **searchCollectionsRequest** | [SearchCollectionsRequest](SearchCollectionsRequest.md) |  | [Optional] |
+
+### Return type
+
+[**SearchCollectionsResponse**](SearchCollectionsResponse.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** | Successful operation |  -  |
+| **403** | Forbidden |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## searchTemplates
+
+> TemplateSearchResponse searchTemplates(publicId, folder, maxResults, nextCursor)
+
+Search creative automation templates
+
+List templates in your Cloudinary account. A template combines transformations, variables, and supporting assets (images, fonts, and related resources) into a single reusable creative unit. Templates are typically exported from design tools such as Figma or Photoshop, uploaded to Cloudinary, and consumed by downstream platforms like Braze and Klaviyo for creative automation workflows. Optionally filter by id, folder, or page through results.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { SearchTemplatesRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // string | Limit results to a specific template id (optional)
+    publicId: publicId_example,
+    // string | Limit results to assets under this folder path (optional)
+    folder: folder_example,
+    // number | Maximum number of results per page (optional)
+    maxResults: 56,
+    // string | Cursor for the next page of results (optional)
+    nextCursor: nextCursor_example,
+  } satisfies SearchTemplatesRequest;
+
+  try {
+    const data = await api.searchTemplates(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **publicId** | `string` | Limit results to a specific template id | [Optional] [Defaults to `undefined`] |
+| **folder** | `string` | Limit results to assets under this folder path | [Optional] [Defaults to `undefined`] |
+| **maxResults** | `number` | Maximum number of results per page | [Optional] [Defaults to `undefined`] |
+| **nextCursor** | `string` | Cursor for the next page of results | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**TemplateSearchResponse**](TemplateSearchResponse.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)
+
+
+## showCollection
+
+> Collection showCollection(collectionId, sortBy, maxResults, nextCursor, withMetadata)
+
+Get a single collection with its assets
+
+Returns collection details and its contained assets. Supports asset pagination (max_results/next_cursor), sorting, and optional metadata inclusion.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { ShowCollectionRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // string | Collection external ID
+    collectionId: collectionId_example,
+    // string | Sort field (optional)
+    sortBy: sortBy_example,
+    // number | Maximum number of assets to return (optional)
+    maxResults: 8.14,
+    // string | Pagination cursor (optional)
+    nextCursor: nextCursor_example,
+    // boolean | Include metadata (optional)
+    withMetadata: true,
+  } satisfies ShowCollectionRequest;
+
+  try {
+    const data = await api.showCollection(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **collectionId** | `string` | Collection external ID | [Defaults to `undefined`] |
+| **sortBy** | `string` | Sort field | [Optional] [Defaults to `undefined`] |
+| **maxResults** | `number` | Maximum number of assets to return | [Optional] [Defaults to `undefined`] |
+| **nextCursor** | `string` | Pagination cursor | [Optional] [Defaults to `undefined`] |
+| **withMetadata** | `boolean` | Include metadata | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**Collection**](Collection.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 |  -  |
+| **403** | Forbidden |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## updateAssetBackreferences
+
+> UpdateBackreferencesResponse updateAssetBackreferences(updateAssetBackreferencesRequest)
+
+Create, update, or remove asset backreferences
+
+Links or unlinks one or more assets to/from a location in an external system (e.g. a CMS page or design file). Each backreference is stored as versioned history in the asset\'s cld_backreference context.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { UpdateAssetBackreferencesOperationRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // UpdateAssetBackreferencesRequest (optional)
+    updateAssetBackreferencesRequest: ...,
+  } satisfies UpdateAssetBackreferencesOperationRequest;
+
+  try {
+    const data = await api.updateAssetBackreferences(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **updateAssetBackreferencesRequest** | [UpdateAssetBackreferencesRequest](UpdateAssetBackreferencesRequest.md) |  | [Optional] |
+
+### Return type
+
+[**UpdateBackreferencesResponse**](UpdateBackreferencesResponse.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** | Successful operation |  -  |
+| **400** | Bad request - invalid location or parameters |  -  |
+| **404** | Asset 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)
+
+
+## updateAssetMetadata
+
+> UpdateAssetMetadataResponse updateAssetMetadata(updateAssetMetadataRequest)
+
+Update asset contextual and structured metadata
+
+Patches contextual key-value metadata and/or structured metadata fields on an asset identified by its external ID. Context fields are merged with existing values; structured metadata fields are set directly.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { UpdateAssetMetadataOperationRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // UpdateAssetMetadataRequest (optional)
+    updateAssetMetadataRequest: ...,
+  } satisfies UpdateAssetMetadataOperationRequest;
+
+  try {
+    const data = await api.updateAssetMetadata(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **updateAssetMetadataRequest** | [UpdateAssetMetadataRequest](UpdateAssetMetadataRequest.md) |  | [Optional] |
+
+### Return type
+
+[**UpdateAssetMetadataResponse**](UpdateAssetMetadataResponse.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** | 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)
+
+
+## updateAssetTags
+
+> UpdateAssetTagsResponse updateAssetTags(resourceType, updateAssetTagsRequest)
+
+Add or remove a tag on assets
+
+Adds or removes a single tag from one or more assets identified by public_id. The command field controls whether the tag is added or removed. Requires OAuth authentication.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { UpdateAssetTagsOperationRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // string | The resource type (e.g., image, video, raw)
+    resourceType: resourceType_example,
+    // UpdateAssetTagsRequest (optional)
+    updateAssetTagsRequest: ...,
+  } satisfies UpdateAssetTagsOperationRequest;
+
+  try {
+    const data = await api.updateAssetTags(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **resourceType** | `string` | The resource type (e.g., image, video, raw) | [Defaults to `undefined`] |
+| **updateAssetTagsRequest** | [UpdateAssetTagsRequest](UpdateAssetTagsRequest.md) |  | [Optional] |
+
+### Return type
+
+[**UpdateAssetTagsResponse**](UpdateAssetTagsResponse.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** | Tag added successfully |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## updateCollection
+
+> UpdateCollectionResponse updateCollection(collectionId, updateCollectionRequest)
+
+Update a collection
+
+Updates collection properties such as name, description, or dynamic_filters. Caller must have write access.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AssetManagementApi,
+} from '@cloudinary/apps-api';
+import type { UpdateCollectionOperationRequest } 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 AssetManagementApi(config);
+
+  const body = {
+    // string | Collection external ID
+    collectionId: collectionId_example,
+    // UpdateCollectionRequest (optional)
+    updateCollectionRequest: ...,
+  } satisfies UpdateCollectionOperationRequest;
+
+  try {
+    const data = await api.updateCollection(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **collectionId** | `string` | Collection external ID | [Defaults to `undefined`] |
+| **updateCollectionRequest** | [UpdateCollectionRequest](UpdateCollectionRequest.md) |  | [Optional] |
+
+### Return type
+
+[**UpdateCollectionResponse**](UpdateCollectionResponse.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** | Successful operation |  -  |
+| **403** | Forbidden |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+