@cloudinary/apps-api 2.2605.50 → 2.2605.54

package/docs/AuthUser.md

@@ -10,6 +10,7 @@ Name | Type
 `email` | string
 `first_name` | string
 `last_name` | string
+`role` | string
 
 ## Example
 
@@ -22,6 +23,7 @@ const example = {
   "email": null,
   "first_name": null,
   "last_name": null,
+  "role": null,
 } satisfies AuthUser
 
 console.log(example)

package/docs/CreatePortalRequest.md

@@ -0,0 +1,48 @@
+
+# CreatePortalRequest
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`title` | string
+`description` | string
+`status` | string
+`privacy` | string
+`portal_url` | string
+`logo` | string
+`cover` | string
+`collection_ids` | Array<string>
+
+## Example
+
+```typescript
+import type { CreatePortalRequest } from '@cloudinary/apps-api'
+
+// TODO: Update the object below with actual values
+const example = {
+  "title": null,
+  "description": null,
+  "status": null,
+  "privacy": null,
+  "portal_url": null,
+  "logo": null,
+  "cover": null,
+  "collection_ids": null,
+} satisfies CreatePortalRequest
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as CreatePortalRequest
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/CreatePublicLinkRequest.md

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

package/docs/CreateSavedSearchRequest.md

@@ -0,0 +1,42 @@
+
+# CreateSavedSearchRequest
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`name` | string
+`filters` | { [key: string]: any; }
+`query_type` | string
+`email_message` | string
+`shared_with` | [Array<CreateSavedSearchRequestSharedWithInner>](CreateSavedSearchRequestSharedWithInner.md)
+
+## Example
+
+```typescript
+import type { CreateSavedSearchRequest } from '@cloudinary/apps-api'
+
+// TODO: Update the object below with actual values
+const example = {
+  "name": null,
+  "filters": null,
+  "query_type": null,
+  "email_message": null,
+  "shared_with": null,
+} satisfies CreateSavedSearchRequest
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as CreateSavedSearchRequest
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/CreateSavedSearchRequestSharedWithInner.md

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

package/docs/DashboardDataResponse.md

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

package/docs/GetAssetsLastDeliveryRequest.md

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

package/docs/LastDeliveryResponse.md

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

package/docs/ListPortalsResponse.md

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

package/docs/ListPublicLinksResponse.md

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

package/docs/ListSavedSearchesResponse.md

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

package/docs/ListUsersResponse.md

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

package/docs/PlatformApi.md

@@ -10,7 +10,9 @@ All URIs are relative to *http://localhost*
 | [**getAppStorageValue**](PlatformApi.md#getappstoragevalue) | **GET** /v2605/platform/apps/storage/{namespace_token}/{level}/{key} | Get a value from app persistent storage |
 | [**getAuthCredentials**](PlatformApi.md#getauthcredentials) | **GET** /v2605/platform/auth/credentials | Get current user and cloud identity |
 | [**getCustomerByCloud**](PlatformApi.md#getcustomerbycloud) | **GET** /v2605/platform/customers/by-cloud/{cloud_name} | Get a customer by cloud name |
+| [**getDashboardData**](PlatformApi.md#getdashboarddata) | **GET** /v2605/platform/reports/dashboard/{variant} | Get dashboard report data |
 | [**listCustomers**](PlatformApi.md#listcustomers) | **GET** /v2605/platform/customers | List customers (clouds) accessible to the user |
+| [**listUsers**](PlatformApi.md#listusers) | **GET** /v2605/platform/users | List users |
 | [**refreshCloudinaryToken**](PlatformApi.md#refreshcloudinarytoken) | **GET** /v2605/platform/auth/tokens/cloudinary/{type}/refresh | Refresh a Cloudinary token |
 | [**setAppStorageValue**](PlatformApi.md#setappstoragevalueoperation) | **PUT** /v2605/platform/apps/storage/{namespace_token}/{level}/{key} | Set a value in app persistent storage |
 | [**trackAnalyticsEvent**](PlatformApi.md#trackanalyticseventoperation) | **POST** /v2605/platform/analytics | Submit analytics events |
@@ -465,6 +467,93 @@ example().catch(console.error);
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## getDashboardData
+
+> DashboardDataResponse getDashboardData(variant, timespan, maxResults, sortBy, filters, only)
+
+Get dashboard report data
+
+Returns cloud-level dashboard data for the requested variant (e.g. usage and delivery trend widgets). The variant string and the shape of data/items are defined by the upstream reporting service.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  PlatformApi,
+} from '@cloudinary/apps-api';
+import type { GetDashboardDataRequest } from '@cloudinary/apps-api';
+
+async function example() {
+  console.log("🚀 Testing @cloudinary/apps-api SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new PlatformApi(config);
+
+  const body = {
+    // string | Dashboard data variant to fetch
+    variant: variant_example,
+    // string | Time range for the data (optional)
+    timespan: timespan_example,
+    // number | Maximum number of items (optional)
+    maxResults: 8.14,
+    // string | Sort field (optional)
+    sortBy: sortBy_example,
+    // string | Serialized filters (optional)
+    filters: filters_example,
+    // string | Trim response attributes (optional)
+    only: only_example,
+  } satisfies GetDashboardDataRequest;
+
+  try {
+    const data = await api.getDashboardData(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **variant** | `string` | Dashboard data variant to fetch | [Defaults to `undefined`] |
+| **timespan** | `string` | Time range for the data | [Optional] [Defaults to `undefined`] |
+| **maxResults** | `number` | Maximum number of items | [Optional] [Defaults to `undefined`] |
+| **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`] |
+
+### Return type
+
+[**DashboardDataResponse**](DashboardDataResponse.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)
+
+
 ## listCustomers
 
 > ListCustomersResponse listCustomers(nameContains, cloudName, product, sortBy, sortOrder)
@@ -548,6 +637,90 @@ example().catch(console.error);
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## listUsers
+
+> ListUsersResponse listUsers(page, pageSize, sortBy, sortOrder, withDeleted)
+
+List users
+
+Returns the users of the product environment with pagination and sorting. Useful for resolving user identities (e.g. in asset history) and adoption reporting.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  PlatformApi,
+} from '@cloudinary/apps-api';
+import type { ListUsersRequest } from '@cloudinary/apps-api';
+
+async function example() {
+  console.log("🚀 Testing @cloudinary/apps-api SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new PlatformApi(config);
+
+  const body = {
+    // number | Page number (optional)
+    page: 8.14,
+    // number | Results per page (optional)
+    pageSize: 8.14,
+    // string | Sort field (optional)
+    sortBy: sortBy_example,
+    // string | Sort direction (asc/desc) (optional)
+    sortOrder: sortOrder_example,
+    // boolean | Include deleted users (optional)
+    withDeleted: true,
+  } satisfies ListUsersRequest;
+
+  try {
+    const data = await api.listUsers(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **page** | `number` | Page number | [Optional] [Defaults to `undefined`] |
+| **pageSize** | `number` | Results per page | [Optional] [Defaults to `undefined`] |
+| **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`] |
+
+### Return type
+
+[**ListUsersResponse**](ListUsersResponse.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)
+
+
 ## refreshCloudinaryToken
 
 > RefreshTokenResponse refreshCloudinaryToken(type)

package/docs/Portal.md

@@ -0,0 +1,64 @@
+
+# Portal
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`id` | string
+`status` | string
+`privacy` | string
+`title` | string
+`description` | string
+`logo` | any
+`cover` | string
+`theme` | Array<string>
+`delivery_name` | string
+`collection_ids` | Array<string>
+`prevent_download_original` | boolean
+`shared_preset_ids` | Array<string>
+`user_id` | string
+`user_external_id` | string
+`created_at` | string
+`updated_at` | string
+
+## Example
+
+```typescript
+import type { Portal } from '@cloudinary/apps-api'
+
+// TODO: Update the object below with actual values
+const example = {
+  "id": null,
+  "status": null,
+  "privacy": null,
+  "title": null,
+  "description": null,
+  "logo": null,
+  "cover": null,
+  "theme": null,
+  "delivery_name": null,
+  "collection_ids": null,
+  "prevent_download_original": null,
+  "shared_preset_ids": null,
+  "user_id": null,
+  "user_external_id": null,
+  "created_at": null,
+  "updated_at": null,
+} satisfies Portal
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as Portal
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+