@cloudinary/asset-management-mcp 0.9.0-rc.0 → 0.9.0

package/src/mcp-server/tools/assetsRenameAsset.ts

@@ -9,8 +9,12 @@ import { ResourceType$zodSchema } from "../../models/resourcetype.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  resource_type: ResourceType$zodSchema.describe(`The type of resource.`),
-  RequestBody: RenameAssetRequestBody$zodSchema,
+  resource_type: ResourceType$zodSchema.describe(
+    `The type of resource (image, video, or raw).`,
+  ),
+  RequestBody: RenameAssetRequestBody$zodSchema.describe(
+    `The rename request parameters.`,
+  ),
 };
 
 export const tool$assetsRenameAsset: ToolDefinition<typeof args> = {

package/src/mcp-server/tools/assetsUpdateResourceByAssetId.ts

@@ -12,7 +12,9 @@ const args = {
   asset_id: z.string().describe(
     "The asset ID of the resource. Must be a 32-character hexadecimal string.",
   ),
-  ResourceUpdateRequest: ResourceUpdateRequest$zodSchema,
+  ResourceUpdateRequest: ResourceUpdateRequest$zodSchema.describe(
+    `The asset attributes to update.`,
+  ),
 };
 
 export const tool$assetsUpdateResourceByAssetId: ToolDefinition<typeof args> = {
@@ -20,7 +22,7 @@ export const tool$assetsUpdateResourceByAssetId: ToolDefinition<typeof args> = {
   description:
     `Updates an existing asset's metadata, tags, and other attributes using its asset ID
 
-Updates one or more attributes of a specified resource (asset) by its asset ID. This enables you to update details of an asset by its unique and immutable identifier, regardless of public ID, display name, asset folder, resource type or deliver type. Note that you can also update many attributes of an existing asset using the explicit method, which is not rate-limited.
+Updates one or more attributes of a specified resource (asset) by its asset ID. This enables you to update details of an asset by its unique and immutable identifier, regardless of public ID, display name, asset folder, resource type or delivery type. Note that you can also update attributes of an existing asset using the explicit API endpoint.
 `,
   scopes: ["librarian"],
   annotations: {

package/src/mcp-server/tools/foldersCreateFolder.ts

@@ -8,7 +8,9 @@ import { foldersCreateFolder } from "../../funcs/foldersCreateFolder.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  folder: z.string(),
+  folder: z.string().describe(
+    "The full path of the folder, including any nested folders. Must not be empty, and must not contain double slashes or leading/trailing slashes.",
+  ),
 };
 
 export const tool$foldersCreateFolder: ToolDefinition<typeof args> = {

package/src/mcp-server/tools/foldersDestroyFolder.ts

@@ -8,7 +8,9 @@ import { foldersDestroyFolder } from "../../funcs/foldersDestroyFolder.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  folder: z.string(),
+  folder: z.string().describe(
+    "The full path of the folder, including any nested folders. Must not be empty, and must not contain double slashes or leading/trailing slashes.",
+  ),
 };
 
 export const tool$foldersDestroyFolder: ToolDefinition<typeof args> = {

package/src/mcp-server/tools/foldersSearchFolders.ts

@@ -5,15 +5,15 @@
 
 import * as z from "zod";
 import { foldersSearchFolders } from "../../funcs/foldersSearchFolders.js";
-import { ExpressionUnion$zodSchema } from "../../models/searchfoldersop.js";
+import { DirectionEnum$zodSchema } from "../../models/directionenum.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  expression: ExpressionUnion$zodSchema.optional().describe(
-    `The (Lucene-like) string expression specifying the search query, or an object for advanced queries. If not passed, returns all folders (up to max_results).`,
-  ),
-  sort_by: z.array(z.string()).describe(
-    "An array of key-value pairs for sorting. Each value is a key and direction (asc/desc).",
+  expression: z.string().describe(
+    "The (Lucene-like) string expression specifying the search query. If not passed, returns all folders (up to max_results).",
+  ).optional(),
+  sort_by: z.array(z.record(z.string(), DirectionEnum$zodSchema)).describe(
+    "Sort order for the results. Each item maps a field name to a direction.",
   ).optional(),
   max_results: z.int().default(50).describe(
     "Maximum number of folders to return (max 500, default 50).",

package/src/mcp-server/tools/foldersUpdateFolder.ts

@@ -5,12 +5,16 @@
 
 import * as z from "zod";
 import { foldersUpdateFolder } from "../../funcs/foldersUpdateFolder.js";
-import { UpdateFolderRequestBody$zodSchema } from "../../models/updatefolderop.js";
+import { MoveFolderRequest$zodSchema } from "../../models/movefolderrequest.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  folder: z.string(),
-  RequestBody: UpdateFolderRequestBody$zodSchema,
+  folder: z.string().describe(
+    "The full path of the folder, including any nested folders. Must not be empty, and must not contain double slashes or leading/trailing slashes.",
+  ),
+  move_folder_request: MoveFolderRequest$zodSchema.describe(
+    `The new folder path.`,
+  ),
 };
 
 export const tool$foldersUpdateFolder: ToolDefinition<typeof args> = {
@@ -32,7 +36,7 @@ Renames or moves an entire folder (along with all assets it contains) to a new l
     const [result] = await foldersUpdateFolder(
       client,
       args.folder,
-      args.RequestBody,
+      args.move_folder_request,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();
 

package/src/mcp-server/tools/searchSearchAssets.ts

@@ -6,10 +6,10 @@
 import { searchSearchAssets } from "../../funcs/searchSearchAssets.js";
 import { SearchParameters$zodSchema } from "../../models/searchparameters.js";
 import { formatResult, ToolDefinition } from "../tools.js";
-import { ASSET_GALLERY_RESOURCE_URI } from "../widgets/asset-gallery-widget.js";
+import { appUri } from "../apps/uri.js";
 
 const args = {
-  request: SearchParameters$zodSchema,
+  request: SearchParameters$zodSchema.describe(`The search query parameters.`),
 };
 
 export const tool$searchSearchAssets: ToolDefinition<typeof args> = {
@@ -32,7 +32,7 @@ Examples: tags:shirt AND uploaded_at>1d, resource_type:image AND bytes>1mb, fold
     "readOnlyHint": true,
   },
   _meta: {
-    ui: { resourceUri: ASSET_GALLERY_RESOURCE_URI },
+    ui: { resourceUri: appUri("asset-gallery", "search-assets") },
   },
   args,
   tool: async (client, args, ctx) => {

package/src/mcp-server/tools/searchVisualSearchAssets.ts

@@ -8,7 +8,9 @@ import { VisualSearchParametersUnion$zodSchema } from "../../models/visualsearch
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: VisualSearchParametersUnion$zodSchema,
+  request: VisualSearchParametersUnion$zodSchema.describe(
+    `The visual search parameters.`,
+  ),
 };
 
 export const tool$searchVisualSearchAssets: ToolDefinition<typeof args> = {
@@ -18,7 +20,7 @@ export const tool$searchVisualSearchAssets: ToolDefinition<typeof args> = {
 
 Returns a list of resources that are visually similar to a specified image. You can provide the source image for comparison in one of three ways:
 - Provide a URL of an image
-- Specify the public ID or asset ID of an existing image
+- Specify the asset ID of an existing image
 - Provide a textual description
 `,
   scopes: ["librarian"],

package/src/mcp-server/tools/uploadUpload.ts

@@ -6,19 +6,16 @@
 import { uploadUpload } from "../../funcs/uploadUpload.js";
 import { UploadRequest$zodSchema } from "../../models/uploadrequest.js";
 import { UploadResourceType$zodSchema } from "../../models/uploadresourcetype.js";
-import { ASSET_UPLOAD_RESOURCE_URI } from "../widgets/asset-upload-widget.js";
+import { appUri } from "../apps/uri.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
   resource_type: UploadResourceType$zodSchema.default("auto").describe(
-    `The type of resource to upload:
-- "image" for uploading strictly images
-- "video" for uploading strictly videos
-- "raw" for uploading non-media files
-- "auto" for allowing Cloudinary to automatically detect the type of the uploaded file
-`,
+    `The type of resource (image, video, raw, or auto).`,
+  ),
+  upload_request: UploadRequest$zodSchema.describe(
+    `The file to upload and associated parameters.`,
   ),
-  upload_request: UploadRequest$zodSchema,
 };
 
 export const tool$uploadUpload: ToolDefinition<typeof args> = {
@@ -50,7 +47,7 @@ Transform media files using transformation syntax in delivery URLs, which create
     "readOnlyHint": false,
   },
   _meta: {
-    ui: { resourceUri: ASSET_UPLOAD_RESOURCE_URI },
+    ui: { resourceUri: appUri("asset-upload", "upload-asset") },
   },
   args,
   tool: async (client, args, ctx) => {

package/src/mcp-server/tools/usageGetUsage.ts

@@ -8,7 +8,9 @@ import { usageGetUsage } from "../../funcs/usageGetUsage.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  date: z.string().date().optional(),
+  date: z.string().date().describe(
+    "The date for which to retrieve usage details (YYYY-MM-DD). If not specified, returns the current usage.",
+  ).optional(),
 };
 
 export const tool$usageGetUsage: ToolDefinition<typeof args> = {

package/src/mcp-server/tools.ts

@@ -17,6 +17,8 @@ import {
 import * as z from "zod";
 import { CloudinaryAssetMgmtCore } from "../core.js";
 import { ServerRegion$zodSchema } from "../lib/config.js";
+import { enabledAppUriPrefixes, type McpApp } from "./apps/config.js";
+import { shouldForwardToolMeta } from "./apps/tool-hooks.js";
 import { ConsoleLogger } from "./console-logger.js";
 import { MCPServerFlags } from "./flags.js";
 import { MCPScope, mcpScopes } from "./scopes.js";
@@ -139,11 +141,13 @@ export function createRegisterTool(
   allowedTools?: Set<string>,
   dynamic?: boolean,
   annotationFilter?: MCPToolAnnotationFilter,
+  mcpApps?: McpApp[],
 ): [
   <A extends ZodRawShapeCompat | undefined>(tool: ToolDefinition<A>) => void,
   Array<{ name: string; description: string }>,
   Map<string, ToolDefinition<ZodRawShapeCompat | undefined>>,
 ] {
+  const enabledUris = enabledAppUriPrefixes(mcpApps ?? []);
   const tools: Array<{ name: string; description: string }> = [];
   const toolMap = new Map<
     string,
@@ -214,7 +218,9 @@ export function createRegisterTool(
           description: tool.description,
           inputSchema: tool.args,
           annotations: tool.annotations,
-          ...(tool._meta ? { _meta: tool._meta } : {}),
+          ...(shouldForwardToolMeta(tool._meta, enabledUris)
+            ? { _meta: tool._meta }
+            : {}),
         },
         async (args, ctx) => {
           return tool.tool(getSDK(), args, ctx);
@@ -226,7 +232,9 @@ export function createRegisterTool(
         {
           description: tool.description,
           annotations: tool.annotations,
-          ...(tool._meta ? { _meta: tool._meta } : {}),
+          ...(shouldForwardToolMeta(tool._meta, enabledUris)
+            ? { _meta: tool._meta }
+            : {}),
         },
         async (ctx) => {
           return tool.tool(getSDK(), ctx);
@@ -364,16 +372,16 @@ export function registerDynamicTools(
 
     return { content: [{ type: "text", text: parts.join("\n\n") }] };
   });
-  logger.debug("Registered dynamic meta-tool", { name: "describe_tool" });
+  logger.debug("Registered dynamic meta-tool", { name: "describe_tool_input" });
 
   // 3. execute_tool
   server.registerTool("execute_tool", {
     description:
-      "Execute a tool by name with the provided input parameters. If executing a given tool for the first time, it is recommended to call describe_tool_input first to understand the expected input schema.",
+      "Execute a tool by name with its arguments. If executing a given tool for the first time, it is recommended to call describe_tool_input first to understand the expected `arguments` shape.",
     inputSchema: {
-      tool_name: z.string().describe("The name of the tool to execute"),
-      input: z.record(z.string(), z.unknown()).optional().describe(
-        "Input parameters for the tool as a JSON object",
+      name: z.string().describe("The name of the tool to execute"),
+      arguments: z.looseObject({}).optional().describe(
+        "Arguments for the target tool as a JSON object, matching the schema returned by describe_tool_input.",
       ),
     },
     annotations: {
@@ -384,17 +392,17 @@ export function registerDynamicTools(
       openWorldHint: true,
     },
   }, async (args, ctx) => {
-    const def = toolMap.get(args.tool_name);
+    const def = toolMap.get(args.name);
     if (!def) {
       return {
-        content: [{ type: "text", text: `Unknown tool: ${args.tool_name}` }],
+        content: [{ type: "text", text: `Unknown tool: ${args.name}` }],
         isError: true,
       };
     }
 
     let validatedInput: Record<string, unknown> = {};
     if (def.args) {
-      const vres = z.object(def.args).safeParse(args.input ?? {});
+      const vres = z.object(def.args).safeParse(args.arguments ?? {});
       if (vres.success) {
         validatedInput = vres.data;
       } else {
@@ -404,7 +412,7 @@ export function registerDynamicTools(
           content: [{
             type: "text",
             text:
-              `Invalid input for tool ${args.tool_name}:\n<issues>\n${issues}\n</issues>`,
+              `Invalid input for tool ${args.name}:\n<issues>\n${issues}\n</issues>`,
           }],
           isError: true,
         };
@@ -422,7 +430,7 @@ export function registerDynamicTools(
       return {
         content: [{
           type: "text",
-          text: `Error executing tool ${args.tool_name}: ${message}`,
+          text: `Error executing tool ${args.name}: ${message}`,
         }],
         isError: true,
       };

package/src/models/accesscontrolitem.ts

@@ -23,14 +23,38 @@ export const AccessType$zodSchema = z.enum([
   "anonymous",
 ]).describe("The type of access control to apply to the asset.");
 
+/**
+ * The start date and time when anonymous access becomes available. Accepts ISO 8601 string or Unix timestamp.
+ */
+export type Start = string | number;
+
+export const Start$zodSchema: z.ZodType<Start> = z.union([
+  z.string(),
+  z.int(),
+]).describe(
+  "The start date and time when anonymous access becomes available. Accepts ISO 8601 string or Unix timestamp.",
+);
+
+/**
+ * The end date and time when anonymous access expires. Accepts ISO 8601 string or Unix timestamp.
+ */
+export type End = string | number;
+
+export const End$zodSchema: z.ZodType<End> = z.union([
+  z.string(),
+  z.int(),
+]).describe(
+  "The end date and time when anonymous access expires. Accepts ISO 8601 string or Unix timestamp.",
+);
+
 /**
  * Access control rule that defines when and how the asset can be accessed.
  */
 export type AccessControlItem = {
   access_type: AccessType;
   key?: string | undefined;
-  start?: string | undefined;
-  end?: string | undefined;
+  start?: string | number | undefined;
+  end?: string | number | undefined;
 };
 
 export const AccessControlItem$zodSchema: z.ZodType<AccessControlItem> = z
@@ -38,14 +62,20 @@ export const AccessControlItem$zodSchema: z.ZodType<AccessControlItem> = z
     access_type: AccessType$zodSchema.describe(
       "The type of access control to apply to the asset.",
     ),
-    end: z.string().optional().describe(
-      "The end date and time when anonymous access expires (ISO 8601 format).",
+    end: z.union([
+      z.string(),
+      z.int(),
+    ]).optional().describe(
+      "The end date and time when anonymous access expires. Accepts ISO 8601 string or Unix timestamp.",
     ),
     key: z.string().optional().describe(
       "The authentication key identifier for token-based access. Default key is used if not specified or if set to 'default'.",
     ),
-    start: z.string().optional().describe(
-      "The start date and time when anonymous access becomes available (ISO 8601 format).",
+    start: z.union([
+      z.string(),
+      z.int(),
+    ]).optional().describe(
+      "The start date and time when anonymous access becomes available. Accepts ISO 8601 string or Unix timestamp.",
     ),
   }).describe(
     "Access control rule that defines when and how the asset can be accessed.",

package/src/models/assetdeliverytype.ts

@@ -0,0 +1,22 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: bf0f7e855303
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Static asset delivery type.
+ */
+export const AssetDeliveryType = {
+  Asset: "asset",
+} as const;
+/**
+ * Static asset delivery type.
+ */
+export type AssetDeliveryType = ClosedEnum<typeof AssetDeliveryType>;
+
+export const AssetDeliveryType$zodSchema = z.enum([
+  "asset",
+]).describe("Static asset delivery type.");

package/src/models/assignfolderrolesop.ts

@@ -31,7 +31,9 @@ export type AssignFolderRolesRequestRequest = {
 export const AssignFolderRolesRequestRequest$zodSchema: z.ZodType<
   AssignFolderRolesRequestRequest
 > = z.object({
-  assign_folder_roles_request: AssignFolderRolesRequest$zodSchema,
+  assign_folder_roles_request: AssignFolderRolesRequest$zodSchema.describe(
+    "The folder role assignments.",
+  ),
   folder_id: z.string().describe(
     "The immutable identifier of the folder, returned by the Get root folders and Get subfolders endpoints.",
   ),

package/src/models/asyncuploadresponse.ts

@@ -6,7 +6,10 @@
 import * as z from "zod";
 import { ClosedEnum } from "../types/enums.js";
 import { ResourceType, ResourceType$zodSchema } from "./resourcetype.js";
-import { StorageType, StorageType$zodSchema } from "./storagetype.js";
+import {
+  UploadDeliveryType,
+  UploadDeliveryType$zodSchema,
+} from "./uploaddeliverytype.js";
 
 /**
  * The status of the asynchronous upload. Will be 'pending' for async uploads.
@@ -33,7 +36,7 @@ export const AsyncUploadResponseStatus$zodSchema = z.enum([
 export type AsyncUploadResponse = {
   status: AsyncUploadResponseStatus;
   resource_type?: ResourceType | undefined;
-  type: StorageType;
+  type: UploadDeliveryType;
   public_id?: string | undefined;
   batch_id: string;
   requester_ip?: string | undefined;
@@ -56,7 +59,9 @@ export const AsyncUploadResponse$zodSchema: z.ZodType<AsyncUploadResponse> = z
     status: AsyncUploadResponseStatus$zodSchema.describe(
       "The status of the asynchronous upload. Will be 'pending' for async uploads.",
     ),
-    type: StorageType$zodSchema.describe("The storage type of the resource."),
+    type: UploadDeliveryType$zodSchema.describe(
+      "Delivery types accepted by upload and rename operations.",
+    ),
   }).describe(
     "Response returned when an upload is processed asynchronously (async=true)",
   );

package/src/models/backupversionfailure.ts

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1746f046a48e
+ */
+
+import * as z from "zod";
+
+export type BackupVersionFailure = {
+  version_id?: string | undefined;
+  error?: string | undefined;
+};
+
+export const BackupVersionFailure$zodSchema: z.ZodType<BackupVersionFailure> = z
+  .object({
+    error: z.string().optional().describe(
+      "The error message explaining the failure.",
+    ),
+    version_id: z.string().optional().describe(
+      "Hexadecimal version ID; length is a positive multiple of 32 (typically 32 or 64).",
+    ),
+  });

package/src/models/componentsdestroyrequest.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a90e8950d8e0
+ */
+
+import * as z from "zod";
+
+export type ComponentsDestroyRequest = {
+  asset_id: string;
+  invalidate?: boolean | undefined;
+  notification_url?: string | undefined;
+  callback?: string | undefined;
+};
+
+export const ComponentsDestroyRequest$zodSchema: z.ZodType<
+  ComponentsDestroyRequest
+> = z.object({
+  asset_id: z.string().describe("A 32-character hexadecimal asset ID."),
+  callback: z.string().optional().describe(
+    "URL for redirect after operation completion.",
+  ),
+  invalidate: z.boolean().optional().describe(
+    "Whether to invalidate CDN cache. Default is false.",
+  ),
+  notification_url: z.string().optional().describe(
+    "URL to receive completion notification.",
+  ),
+});

package/src/models/componentsdestroyresponse.ts

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: e062c4f7f877
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * The result of the deletion operation.
+ */
+export const ComponentsDestroyResponseResult = {
+  Ok: "ok",
+  NotFound: "not found",
+} as const;
+/**
+ * The result of the deletion operation.
+ */
+export type ComponentsDestroyResponseResult = ClosedEnum<
+  typeof ComponentsDestroyResponseResult
+>;
+
+export const ComponentsDestroyResponseResult$zodSchema = z.enum([
+  "ok",
+  "not found",
+]).describe("The result of the deletion operation.");
+
+export type ComponentsDestroyResponse = {
+  result: ComponentsDestroyResponseResult;
+};
+
+export const ComponentsDestroyResponse$zodSchema: z.ZodType<
+  ComponentsDestroyResponse
+> = z.object({
+  result: ComponentsDestroyResponseResult$zodSchema.describe(
+    "The result of the deletion operation.",
+  ),
+});

package/src/models/contextfullresponse.ts

@@ -0,0 +1,42 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: cad93d606839
+ */
+
+import * as z from "zod";
+import { collectExtraKeys as collectExtraKeys$ } from "../lib/schemas.js";
+
+/**
+ * Contextual metadata grouped by kind. Custom user context appears under the 'custom' key. Other context kinds may also appear as additional keys.
+ */
+export type ContextFullResponse = {
+  custom?: { [k: string]: string } | undefined;
+  AdditionalProperties?: { [k: string]: { [k: string]: string } };
+};
+
+export const ContextFullResponse$zodSchema: z.ZodType<ContextFullResponse> =
+  collectExtraKeys$(
+    z.object({
+      custom: z.record(z.string(), z.string()).optional().describe(
+        "User-defined contextual metadata as key-value pairs.",
+      ),
+    }).describe(
+      "Contextual metadata grouped by kind. Custom user context appears under the 'custom' key. Other context kinds may also appear as additional keys.",
+    ).catchall(z.record(z.string(), z.string())),
+    "AdditionalProperties",
+    true,
+  );
+
+export const ContextFullResponse$zodSchemaOutbound: z.ZodType<any> = z.object({
+  AdditionalProperties: z.record(z.string(), z.record(z.string(), z.string()))
+    .optional(),
+  custom: z.record(z.string(), z.string()).optional(),
+}).describe(
+  "Contextual metadata grouped by kind. Custom user context appears under the 'custom' key. Other context kinds may also appear as additional keys.",
+).transform((v) => {
+  const { AdditionalProperties, ...rest } = v;
+  return {
+    ...rest,
+    ...AdditionalProperties,
+  };
+});

package/src/models/coordinatesresponse.ts

@@ -0,0 +1,24 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 4f951f1842fb
+ */
+
+import * as z from "zod";
+
+/**
+ * Coordinate data for faces and custom regions.
+ */
+export type CoordinatesResponse = {
+  faces?: Array<Array<number>> | undefined;
+  custom?: Array<Array<number>> | undefined;
+};
+
+export const CoordinatesResponse$zodSchema: z.ZodType<CoordinatesResponse> = z
+  .object({
+    custom: z.array(z.array(z.number())).optional().describe(
+      "Custom coordinate rectangles [x, y, width, height].",
+    ),
+    faces: z.array(z.array(z.int())).optional().describe(
+      "Detected face coordinate rectangles [x, y, width, height].",
+    ),
+  }).describe("Coordinate data for faces and custom regions.");

package/src/models/createassetrelationsbyassetidop.ts

@@ -9,6 +9,10 @@ import {
   AssetRelationsResponse,
   AssetRelationsResponse$zodSchema,
 } from "./assetrelationsresponse.js";
+import {
+  RelateAssetsByAssetIdRequest,
+  RelateAssetsByAssetIdRequest$zodSchema,
+} from "./relateassetsbyassetidrequest.js";
 
 export type CreateAssetRelationsByAssetIdGlobals = {
   cloud_name?: string | undefined;
@@ -21,30 +25,19 @@ export const CreateAssetRelationsByAssetIdGlobals$zodSchema: z.ZodType<
     .optional(),
 });
 
-export type CreateAssetRelationsByAssetIdRequestBody = {
-  assets_to_relate: Array<string>;
-};
-
-export const CreateAssetRelationsByAssetIdRequestBody$zodSchema: z.ZodType<
-  CreateAssetRelationsByAssetIdRequestBody
-> = z.object({
-  assets_to_relate: z.array(z.string()).describe(
-    "Relates the asset to all the assets specified in this array of up to 10 assets, specified by their asset IDs.",
-  ),
-});
-
 export type CreateAssetRelationsByAssetIdRequest = {
   asset_id: string;
-  RequestBody: CreateAssetRelationsByAssetIdRequestBody;
+  relate_assets_by_asset_id_request: RelateAssetsByAssetIdRequest;
 };
 
 export const CreateAssetRelationsByAssetIdRequest$zodSchema: z.ZodType<
   CreateAssetRelationsByAssetIdRequest
 > = z.object({
-  RequestBody: z.lazy(() => CreateAssetRelationsByAssetIdRequestBody$zodSchema),
   asset_id: z.string().describe(
     "The asset ID of the resource. Must be a 32-character hexadecimal string.",
   ),
+  relate_assets_by_asset_id_request: RelateAssetsByAssetIdRequest$zodSchema
+    .describe("The asset IDs to relate."),
 });
 
 export type CreateAssetRelationsByAssetIdResponse =