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

package/src/models/generatearchiveop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 0c28b0f5b136
  */
 
 import * as z from "zod";
@@ -92,28 +93,72 @@ export type GenerateArchiveRequestBody = {
 export const GenerateArchiveRequestBody$zodSchema: z.ZodType<
   GenerateArchiveRequestBody
 > = z.object({
-  allow_missing: z.boolean().default(false),
-  api_key: z.string().optional(),
-  async: z.boolean().default(false),
-  expires_at: z.int().optional(),
-  flatten_folders: z.boolean().default(false),
-  flatten_transformations: z.boolean().default(false),
-  keep_derived: z.boolean().default(false),
-  mode: Mode$zodSchema.default("create"),
-  notification_url: z.string().optional(),
-  prefixes: z.array(z.string()).optional(),
-  public_ids: z.array(z.string()).optional(),
-  signature: z.string().optional(),
-  skip_transformation_name: z.boolean().default(false),
-  tags: z.array(z.string()).optional(),
-  target_asset_folder: z.string().optional(),
-  target_format: TargetFormat$zodSchema.default("zip"),
-  target_public_id: z.string().optional(),
-  target_tags: z.array(z.string()).optional(),
-  timestamp: z.int().optional(),
-  transformations: z.string().optional(),
-  type: ArchiveStorageType$zodSchema.optional(),
-  use_original_filename: z.boolean().default(false),
+  allow_missing: z.boolean().default(false).describe(
+    "Whether to allow missing assets in the archive. If false, the operation will fail if any asset is not found.",
+  ),
+  api_key: z.string().optional().describe(
+    "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs.",
+  ),
+  async: z.boolean().default(false).describe(
+    "(\"create\" mode only), specifies whether to generate the archive asynchronously.",
+  ),
+  expires_at: z.int().optional().describe(
+    "(\"download\" mode only) Unix timestamp indicating when the generated archive URL should expire.",
+  ),
+  flatten_folders: z.boolean().default(false).describe(
+    "Whether to flatten all files to be in the root of the archive file.",
+  ),
+  flatten_transformations: z.boolean().default(false).describe(
+    "Whether to flatten the folder structure of the derived assets.",
+  ),
+  keep_derived: z.boolean().default(false).describe(
+    "Whether to keep the derived assets used for generating the archive.",
+  ),
+  mode: Mode$zodSchema.default("create").describe(
+    "The method for generating and delivering the archive. Only \"create\" is supported:\ncreate - Creates and stores the archive as a raw asset, returning URLs in the response\n",
+  ),
+  notification_url: z.string().optional().describe(
+    "(\"create\" mode only), specifies the URL to notify when the archive generation is complete.",
+  ),
+  prefixes: z.array(z.string()).optional().describe(
+    "Select all assets where the public ID starts with this prefix. Up to 20 prefixes are supported.",
+  ),
+  public_ids: z.array(z.string()).optional().describe(
+    "The list of public IDs to include in the archive. Up to 1000 public IDs are supported.",
+  ),
+  signature: z.string().optional().describe(
+    "(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters.\n",
+  ),
+  skip_transformation_name: z.boolean().default(false).describe(
+    "Whether to skip adding the transformation details to the file names in the archive.",
+  ),
+  tags: z.array(z.string()).optional().describe(
+    "A tag to use for selecting assets to include in the archive. Up to 20 tags are supported.",
+  ),
+  target_asset_folder: z.string().optional().describe(
+    "The folder in your product environment where the generated archive should be stored.",
+  ),
+  target_format: TargetFormat$zodSchema.default("zip").describe(
+    "The format of the generated archive.",
+  ),
+  target_public_id: z.string().optional().describe(
+    "The public ID to assign to the generated archive, or the filename of the downloaded archive file.",
+  ),
+  target_tags: z.array(z.string()).optional().describe(
+    "A list of tag names to assign to the generated archive.",
+  ),
+  timestamp: z.int().optional().describe(
+    "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs.",
+  ),
+  transformations: z.string().optional().describe(
+    "The transformations to apply to the assets before including them in the archive (separated by \"|\").",
+  ),
+  type: ArchiveStorageType$zodSchema.optional().describe(
+    "The storage type of resources to include in the archive.",
+  ),
+  use_original_filename: z.boolean().default(false).describe(
+    "Whether to use the original filenames of the assets in the archive instead of public IDs (when available).",
+  ),
 });
 
 export type GenerateArchiveRequest = {
@@ -125,7 +170,9 @@ export const GenerateArchiveRequest$zodSchema: z.ZodType<
   GenerateArchiveRequest
 > = z.object({
   RequestBody: z.lazy(() => GenerateArchiveRequestBody$zodSchema),
-  resource_type: ArchiveResourceType$zodSchema,
+  resource_type: ArchiveResourceType$zodSchema.describe(
+    "The type of resources to include in the archive. \"image\" for images, \"video\" for videos, \"raw\" for non-media files, or \"all\" for mixed types.",
+  ),
 });
 
 /**
@@ -156,25 +203,63 @@ export type GenerateArchiveResponseBody = {
 export const GenerateArchiveResponseBody$zodSchema: z.ZodType<
   GenerateArchiveResponseBody
 > = z.object({
-  asset_folder: z.string().optional(),
-  asset_id: z.string().optional(),
-  bytes: z.int().optional(),
-  created_at: z.iso.datetime({ offset: true }).optional(),
-  display_name: z.string().optional(),
-  empty_prefixes: z.array(z.string()).optional(),
-  empty_tags: z.array(z.string()).optional(),
-  file_count: z.int().optional(),
-  folder: z.string().optional(),
-  missing_public_ids: z.array(z.string()).optional(),
-  public_id: z.string().optional(),
-  resource_count: z.int().optional(),
-  resource_type: z.string().optional(),
-  secure_url: z.string().optional(),
-  tags: z.array(z.string()).optional(),
-  type: z.string().optional(),
-  url: z.string().optional(),
-  version: z.int().optional(),
-  version_id: z.string().optional(),
+  asset_folder: z.string().optional().describe(
+    "The folder in your product environment where the archive is stored.",
+  ),
+  asset_id: z.string().optional().describe(
+    "The unique identifier of the generated archive in the Cloudinary system.",
+  ),
+  bytes: z.int().optional().describe(
+    "The size of the generated archive in bytes.",
+  ),
+  created_at: z.iso.datetime({ offset: true }).optional().describe(
+    "The timestamp when the archive was generated.",
+  ),
+  display_name: z.string().optional().describe(
+    "The display name of the generated archive.",
+  ),
+  empty_prefixes: z.array(z.string()).optional().describe(
+    "The list of prefixes that were requested but returned no results.",
+  ),
+  empty_tags: z.array(z.string()).optional().describe(
+    "The list of tags that were requested but returned no results.",
+  ),
+  file_count: z.int().optional().describe(
+    "The total number of files in the archive.",
+  ),
+  folder: z.string().optional().describe(
+    "The folder where the archive is stored (only for product environments with Dynamic Folders disabled)",
+  ),
+  missing_public_ids: z.array(z.string()).optional().describe(
+    "The list of public IDs that were requested but not found.",
+  ),
+  public_id: z.string().optional().describe(
+    "The public ID of the generated archive.",
+  ),
+  resource_count: z.int().optional().describe(
+    "The number of unique resources included in the archive.",
+  ),
+  resource_type: z.string().optional().describe(
+    "The type of resource. Always \"raw\" for generated archives.",
+  ),
+  secure_url: z.string().optional().describe(
+    "The HTTPS URL for downloading the generated archive.",
+  ),
+  tags: z.array(z.string()).optional().describe(
+    "The tags assigned to the generated archive.",
+  ),
+  type: z.string().optional().describe(
+    "The resource type of the generated archive.",
+  ),
+  url: z.string().optional().describe(
+    "The HTTP URL for downloading the generated archive.",
+  ),
+  version: z.int().optional().describe(
+    "The version number of the generated archive.",
+  ),
+  version_id: z.string().optional().describe(
+    "The unique identifier of this version of the generated archive.",
+  ),
 }).describe("Archive successfully generated or downloaded");
 
 export type GenerateArchiveResponse =

package/src/models/getfolderrolesop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: af070f1be2e4
  */
 
 import * as z from "zod";

package/src/models/getpersonop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3681227fdc16
  */
 
 import * as z from "zod";
@@ -31,7 +32,9 @@ export type GetPersonResponseBody = { person?: PersonDetails | undefined };
 
 export const GetPersonResponseBody$zodSchema: z.ZodType<GetPersonResponseBody> =
   z.object({
-    person: PersonDetails$zodSchema.optional(),
+    person: PersonDetails$zodSchema.optional().describe(
+      "Detailed information about a recognized person.",
+    ),
   }).describe("Person retrieved successfully");
 
 export type GetPersonResponse = ApiError | GetPersonResponseBody;

package/src/models/getresourcebyassetidop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ff6558def3e3
  */
 
 import * as z from "zod";

package/src/models/getresourcebypublicidop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a9e9b88056c4
  */
 
 import * as z from "zod";
@@ -71,8 +72,10 @@ export const GetResourceByPublicIdRequest$zodSchema: z.ZodType<
   quality_analysis: z.boolean().default(false).describe(
     "Whether to return quality analysis scores for the image. Default: false.",
   ),
-  resource_type: ResourceType$zodSchema,
-  type: ExtendedStorageType$zodSchema,
+  resource_type: ResourceType$zodSchema.describe("The type of resource."),
+  type: ExtendedStorageType$zodSchema.describe(
+    "The extended storage type of the resource.",
+  ),
   versions: z.boolean().default(false).describe(
     "Whether to include details of all the backed up versions of the asset. Default: false.",
   ),

package/src/models/getusageop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 247c505056a9
  */
 
 import * as z from "zod";

package/src/models/getvideoviewsop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f526444117c0
  */
 
 import * as z from "zod";
@@ -60,7 +61,9 @@ export const GetVideoViewsRequest$zodSchema: z.ZodType<GetVideoViewsRequest> = z
     next_cursor: z.string().describe(
       "The cursor for pagination. Use the next_cursor value from a previous response to get the next page of results.",
     ).optional(),
-    sort_by: GetVideoViewsSortBy$zodSchema.default("-view_ended_at"),
+    sort_by: GetVideoViewsSortBy$zodSchema.default("-view_ended_at").describe(
+      "Specifies the expression field by which to sort the results. Prepend values with a '-' to reverse the order.",
+    ),
   });
 
 export type Data = {
@@ -76,15 +79,33 @@ export type Data = {
 };
 
 export const Data$zodSchema: z.ZodType<Data> = z.object({
-  video_duration: z.number().nullable().optional(),
-  video_extension: z.string().nullable().optional(),
-  video_public_id: z.string().optional(),
-  video_transformation: z.string().nullable().optional(),
-  view_ended_at: z.iso.datetime({ offset: true }).optional(),
-  view_watch_time: z.number().nullable().optional(),
-  viewer_application_name: z.string().nullable().optional(),
-  viewer_location_country_code: z.string().nullable().optional(),
-  viewer_os_identifier: z.string().nullable().optional(),
+  video_duration: z.number().nullable().optional().describe(
+    "The duration in seconds of the video",
+  ),
+  video_extension: z.string().nullable().optional().describe(
+    "The file extension of the video",
+  ),
+  video_public_id: z.string().optional().describe(
+    "The full public ID of the video",
+  ),
+  video_transformation: z.string().nullable().optional().describe(
+    "The transformation applied to the video",
+  ),
+  view_ended_at: z.iso.datetime({ offset: true }).optional().describe(
+    "The date when the video view ended",
+  ),
+  view_watch_time: z.number().nullable().optional().describe(
+    "The length of time the video was viewed",
+  ),
+  viewer_application_name: z.string().nullable().optional().describe(
+    "The application used to view the video",
+  ),
+  viewer_location_country_code: z.string().nullable().optional().describe(
+    "The 2-digit ISO country code of the viewer location",
+  ),
+  viewer_os_identifier: z.string().nullable().optional().describe(
+    "The full identifier for the viewer's operating system",
+  ),
 });
 
 /**
@@ -100,8 +121,10 @@ export const GetVideoViewsResponseBody$zodSchema: z.ZodType<
   GetVideoViewsResponseBody
 > = z.object({
   data: z.array(z.lazy(() => Data$zodSchema)).optional(),
-  next_cursor: z.string().optional(),
-  request_id: z.string().optional(),
+  next_cursor: z.string().optional().describe("Cursor value for pagination"),
+  request_id: z.string().optional().describe(
+    "Unique identifier for the request",
+  ),
 }).describe("List of video views retrieved");
 
 export type GetVideoViewsResponse = ApiError | GetVideoViewsResponseBody;

package/src/models/info.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 70f4d95abf4e
  */
 
 import * as z from "zod";
@@ -60,10 +61,18 @@ export type Derivative = {
 };
 
 export const Derivative$zodSchema: z.ZodType<Derivative> = z.object({
-  id: z.string().optional(),
-  secure_url: z.string().optional(),
-  transformation: z.string().optional(),
-  transformation_signature: z.string().optional(),
+  id: z.string().optional().describe(
+    "The unique identifier of the derived resource",
+  ),
+  secure_url: z.string().optional().describe(
+    "The secure URL for accessing the derived resource",
+  ),
+  transformation: z.string().optional().describe(
+    "The transformation string that was applied",
+  ),
+  transformation_signature: z.string().optional().describe(
+    "The unique signature of the transformation",
+  ),
 });
 
 export type Info = {
@@ -107,7 +116,9 @@ export type Info = {
 
 export const Info$zodSchema: z.ZodType<Info> = z.object({
   access_control: z.array(AccessControlItem$zodSchema).nullable().optional(),
-  animated: z.boolean().nullable().optional(),
+  animated: z.boolean().nullable().optional().describe(
+    "Whether the asset is animated (e.g., GIF, animated WebP). Null for non-animated assets.",
+  ),
   aspect_ratio: z.number().nullable().optional(),
   asset_folder: z.string().optional(),
   asset_id: z.string().optional(),
@@ -117,31 +128,51 @@ export const Info$zodSchema: z.ZodType<Info> = z.object({
   context: z.union([
     z.lazy(() => InfoContext1$zodSchema),
     z.array(z.lazy(() => InfoContext2$zodSchema)),
-  ]).nullable().optional(),
+  ]).nullable().optional().describe(
+    "Included if 'context=true' parameter is used. Can be object with custom properties or array of key-value pairs.",
+  ),
   created_at: z.iso.datetime({ offset: true }).optional(),
-  derivatives: z.array(z.lazy(() => Derivative$zodSchema)).nullable()
-    .optional(),
+  derivatives: z.array(z.lazy(() => Derivative$zodSchema)).nullable().optional()
+    .describe(
+      "Included if 'derived=true' parameter is used. Null when no derivatives exist.",
+    ),
   display_name: z.string().optional(),
-  duration: z.number().nullable().optional(),
+  duration: z.number().nullable().optional().describe(
+    "Duration in seconds for video/audio assets. Null for images.",
+  ),
   etag: z.string().optional(),
   filename: z.string().optional(),
   folder: z.string().optional(),
   format: z.string().optional(),
   height: z.int().nullable().optional(),
   metadata: z.record(z.string(), z.any()).optional(),
-  moderation: z.array(z.lazy(() => Moderation$zodSchema)).optional(),
-  moderation_kind: z.string().optional(),
-  moderation_status: z.string().optional(),
+  moderation: z.array(z.lazy(() => Moderation$zodSchema)).optional().describe(
+    "Included if 'moderations=true' parameter is used.",
+  ),
+  moderation_kind: z.string().optional().describe(
+    "The type of moderation applied to the asset.",
+  ),
+  moderation_status: z.string().optional().describe(
+    "The current status of the moderation process for the asset.",
+  ),
   pixels: z.int().nullable().optional(),
   public_id: z.string().optional(),
   related_assets: z.array(z.lazy(() => RelatedAsset$zodSchema)).nullable()
-    .optional(),
-  resource_subtype: z.string().nullable().optional(),
+    .optional().describe(
+      "Related assets linked to this resource. Null when none linked.",
+    ),
+  resource_subtype: z.string().nullable().optional().describe(
+    "The subtype of the resource (e.g., for video). Null when not applicable.",
+  ),
   resource_type: z.string().optional(),
   secure_url: z.string().optional(),
   status: z.string().optional(),
-  substatus: z.string().nullable().optional(),
-  tags: z.array(z.string()).nullable().optional(),
+  substatus: z.string().nullable().optional().describe(
+    "The substatus of the resource. Null when not set.",
+  ),
+  tags: z.array(z.string()).nullable().optional().describe(
+    "Included if 'tags=true' parameter is used.",
+  ),
   type: z.string().optional(),
   uploaded_at: z.iso.datetime({ offset: true }).optional(),
   url: z.string().optional(),

package/src/models/listimagesop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2d4428cd7790
  */
 
 import * as z from "zod";
@@ -35,7 +36,7 @@ export type ListImagesRequest = {
 
 export const ListImagesRequest$zodSchema: z.ZodType<ListImagesRequest> = z
   .object({
-    direction: Direction$zodSchema.optional(),
+    direction: Direction$zodSchema.optional().describe("Sort direction."),
     fields: z.array(FieldsSpec$zodSchema).optional(),
     max_results: z.int().describe(
       "Maximum number of results to return (1-500).",
@@ -53,7 +54,9 @@ export const ListImagesRequest$zodSchema: z.ZodType<ListImagesRequest> = z
     tags: z.boolean().describe(
       "Whether to include the list of tag names assigned to each asset. Default: false",
     ).optional(),
-    type: ListStorageType$zodSchema.optional(),
+    type: ListStorageType$zodSchema.optional().describe(
+      "The storage type of the assets. Necessary for prefix filtering.",
+    ),
   });
 
 export type ListImagesResponse = ApiError | ListResponse;

package/src/models/listpeopleop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 81f94f065dc1
  */
 
 import * as z from "zod";
@@ -75,19 +76,27 @@ export type ListPeopleRequest = {
 
 export const ListPeopleRequest$zodSchema: z.ZodType<ListPeopleRequest> = z
   .object({
-    direction: ParametersDirection$zodSchema.optional(),
+    direction: ParametersDirection$zodSchema.optional().describe(
+      "The sort direction for the results. Default is \"desc\".",
+    ),
     max_results: z.int().default(50).describe(
       "The maximum number of people to return. Default: 50.",
     ),
     name_prefix: z.string().describe(
       "Filter people whose names start with the given prefix (case insensitive).",
     ).optional(),
-    name_status: NameStatus$zodSchema.default("all"),
+    name_status: NameStatus$zodSchema.default("all").describe(
+      "Filter by whether the person has been named. Default: all.",
+    ),
     next_cursor: z.string().describe(
       "The cursor for pagination. Use the next_cursor value from a previous response to get the next page of results.",
     ).optional(),
-    sort_by: ListPeopleSortBy$zodSchema.default("name"),
-    status: PersonStatus$zodSchema.optional(),
+    sort_by: ListPeopleSortBy$zodSchema.default("name").describe(
+      "The field to sort results by. Default: name (ascending).\n",
+    ),
+    status: PersonStatus$zodSchema.optional().describe(
+      "Filter by person status.",
+    ),
   });
 
 /**
@@ -101,8 +110,12 @@ export type ListPeopleResponseBody = {
 export const ListPeopleResponseBody$zodSchema: z.ZodType<
   ListPeopleResponseBody
 > = z.object({
-  next_cursor: z.string().optional(),
-  people: z.array(PersonDetails$zodSchema).optional(),
+  next_cursor: z.string().optional().describe(
+    "The cursor to use for the next page of results.",
+  ),
+  people: z.array(PersonDetails$zodSchema).optional().describe(
+    "A list of recognized person objects.",
+  ),
 }).describe("People retrieved successfully");
 
 export type ListPeopleResponse = ApiError | ListPeopleResponseBody;

package/src/models/listrawfilesop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 08feb5513e5a
  */
 
 import * as z from "zod";
@@ -35,7 +36,7 @@ export type ListRawFilesRequest = {
 
 export const ListRawFilesRequest$zodSchema: z.ZodType<ListRawFilesRequest> = z
   .object({
-    direction: Direction$zodSchema.optional(),
+    direction: Direction$zodSchema.optional().describe("Sort direction."),
     fields: z.array(FieldsSpec$zodSchema).optional(),
     max_results: z.int().describe(
       "Maximum number of results to return (1-500).",
@@ -53,7 +54,9 @@ export const ListRawFilesRequest$zodSchema: z.ZodType<ListRawFilesRequest> = z
     tags: z.boolean().describe(
       "Whether to include the list of tag names assigned to each asset. Default: false",
     ).optional(),
-    type: ListStorageType$zodSchema.optional(),
+    type: ListStorageType$zodSchema.optional().describe(
+      "The delivery type. Necessary for prefix filtering.",
+    ),
   });
 
 export type ListRawFilesResponse = ApiError | ListResponse;

package/src/models/listresourcesbyassetfolderop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 80c57b5f8785
  */
 
 import * as z from "zod";
@@ -33,12 +34,14 @@ export const ListResourcesByAssetFolderRequest$zodSchema: z.ZodType<
   ListResourcesByAssetFolderRequest
 > = z.object({
   asset_folder: z.string().describe("The full path of the asset folder."),
-  direction: Direction$zodSchema.optional(),
+  direction: Direction$zodSchema.optional().describe("Sort direction."),
   fields: z.array(FieldsSpec$zodSchema).optional(),
   max_results: z.int().describe("Maximum number of results to return (1-500).")
     .optional(),
   next_cursor: z.string().describe("Cursor for pagination.").optional(),
-  resource_type: ResourceType$zodSchema.optional(),
+  resource_type: ResourceType$zodSchema.optional().describe(
+    "Filter by resource type within the folder.",
+  ),
 });
 
 export type ListResourcesByAssetFolderResponse = ApiError | ListResponse;

package/src/models/listresourcesbyassetidsop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9f88436f262a
  */
 
 import * as z from "zod";
@@ -32,7 +33,9 @@ export const ListResourcesByAssetIDsRequest$zodSchema: z.ZodType<
     "List of asset IDs to retrieve (max 100).",
   ),
   fields: z.array(FieldsSpec$zodSchema).optional(),
-  resource_type: ResourceType$zodSchema.optional(),
+  resource_type: ResourceType$zodSchema.optional().describe(
+    "Resource type (optional, can sometimes disambiguate).",
+  ),
 });
 
 export type ListResourcesByAssetIDsResponse = ApiError | ListResponse;

package/src/models/listresourcesbycontextop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 734ed3c59597
  */
 
 import * as z from "zod";
@@ -31,13 +32,13 @@ export type ListResourcesByContextRequest = {
 export const ListResourcesByContextRequest$zodSchema: z.ZodType<
   ListResourcesByContextRequest
 > = z.object({
-  direction: Direction$zodSchema.optional(),
+  direction: Direction$zodSchema.optional().describe("Sort direction."),
   fields: z.array(FieldsSpec$zodSchema).optional(),
   key: z.string().describe("Context key to filter by."),
   max_results: z.int().describe("Maximum number of results to return (1-500).")
     .optional(),
   next_cursor: z.string().describe("Cursor for pagination.").optional(),
-  resource_type: ResourceType$zodSchema,
+  resource_type: ResourceType$zodSchema.describe("The type of resource."),
   value: z.string().describe("Context value to filter by.").optional(),
 });
 

package/src/models/listresourcesbymoderationkindandstatusop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 37a42f17fdd2
  */
 
 import * as z from "zod";
@@ -75,7 +76,7 @@ export type ListResourcesByModerationKindAndStatusRequest = {
 export const ListResourcesByModerationKindAndStatusRequest$zodSchema: z.ZodType<
   ListResourcesByModerationKindAndStatusRequest
 > = z.object({
-  direction: Direction$zodSchema.optional(),
+  direction: Direction$zodSchema.optional().describe("Sort direction."),
   fields: z.array(FieldsSpec$zodSchema).optional(),
   max_results: z.int().describe("Maximum number of results to return (1-500).")
     .optional(),
@@ -83,7 +84,7 @@ export const ListResourcesByModerationKindAndStatusRequest$zodSchema: z.ZodType<
   moderation_status:
     ListResourcesByModerationKindAndStatusModerationStatus$zodSchema,
   next_cursor: z.string().describe("Cursor for pagination.").optional(),
-  resource_type: ResourceType$zodSchema,
+  resource_type: ResourceType$zodSchema.describe("The type of resource."),
 });
 
 export type ListResourcesByModerationKindAndStatusResponse =

package/src/models/listresourcetagsop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 7ed6ffcc05fc
  */
 
 import * as z from "zod";
@@ -31,7 +32,7 @@ export const ListResourceTagsRequest$zodSchema: z.ZodType<
   prefix: z.string().describe(
     "The prefix to use if you want to limit the returned tags to those that start with the specified prefix.",
   ).optional(),
-  resource_type: ResourceType$zodSchema,
+  resource_type: ResourceType$zodSchema.describe("The type of resource."),
 });
 
 /**