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

package/src/models/destroyrequest.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 55d8b3c6e136
  */
 
 import * as z from "zod";
@@ -15,11 +16,23 @@ export type DestroyRequest = {
 };
 
 export const DestroyRequest$zodSchema: z.ZodType<DestroyRequest> = z.object({
-  api_key: z.string().optional(),
-  asset_id: z.string(),
-  callback: z.string().optional(),
-  invalidate: z.boolean().optional(),
-  notification_url: z.string().optional(),
-  signature: z.string().optional(),
-  timestamp: z.int().optional(),
+  api_key: z.string().optional().describe(
+    "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs.",
+  ),
+  asset_id: z.string().describe("The ID of the asset to delete."),
+  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.",
+  ),
+  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",
+  ),
+  timestamp: z.int().optional().describe(
+    "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs.",
+  ),
 });

package/src/models/destroyresponse.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: d820256ef5c9
  */
 
 import * as z from "zod";
@@ -28,6 +29,8 @@ export type DestroyResponse = {
 };
 
 export const DestroyResponse$zodSchema: z.ZodType<DestroyResponse> = z.object({
-  asset_folder: z.string().optional(),
-  result: Result$zodSchema,
+  asset_folder: z.string().optional().describe(
+    "The asset folder path. Only included when folder decoupling is enabled.",
+  ),
+  result: Result$zodSchema.describe("The result of the deletion operation."),
 });

package/src/models/direction.ts

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

package/src/models/downloadassetop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: dee26fb4539d
  */
 
 import * as z from "zod";
@@ -46,7 +47,7 @@ export const DownloadAssetRequest$zodSchema: z.ZodType<DownloadAssetRequest> = z
       "The format to convert the asset to before downloading.",
     ).optional(),
     public_id: z.string().describe("The public ID of the asset."),
-    resource_type: ResourceType$zodSchema,
+    resource_type: ResourceType$zodSchema.describe("The type of resource."),
     signature: z.string().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",
     ).optional(),
@@ -59,7 +60,9 @@ export const DownloadAssetRequest$zodSchema: z.ZodType<DownloadAssetRequest> = z
     transformation: z.string().describe(
       "A transformation to apply to the asset before downloading.",
     ).optional(),
-    type: StorageType$zodSchema.optional(),
+    type: StorageType$zodSchema.optional().describe(
+      "The storage type of the asset. Default is \"upload\".",
+    ),
   });
 
 export type DownloadAssetResponse =

package/src/models/downloadbackupassetop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 363c7ad4fafa
  */
 
 import * as z from "zod";
@@ -45,7 +46,7 @@ export const DownloadBackupAssetRequest$zodSchema: z.ZodType<
 export type NotFoundError = { message?: string | undefined };
 
 export const NotFoundError$zodSchema: z.ZodType<NotFoundError> = z.object({
-  message: z.string().optional(),
+  message: z.string().optional().describe("Specified version does not exist"),
 });
 
 /**
@@ -69,8 +70,10 @@ export type DownloadBackupAssetUnauthorizedError = {
 export const DownloadBackupAssetUnauthorizedError$zodSchema: z.ZodType<
   DownloadBackupAssetUnauthorizedError
 > = z.object({
-  http_code: z.int().optional(),
-  message: z.string().optional(),
+  http_code: z.int().optional().describe("The HTTP status code."),
+  message: z.string().optional().describe(
+    "Invalid Signature or timestamp expired.",
+  ),
 });
 
 /**
@@ -93,8 +96,10 @@ export type BadRequestError = {
 };
 
 export const BadRequestError$zodSchema: z.ZodType<BadRequestError> = z.object({
-  http_code: z.int().optional(),
-  message: z.string().optional(),
+  http_code: z.int().optional().describe("The HTTP status code."),
+  message: z.string().optional().describe(
+    "A problem with one of the parameters or timestamp.",
+  ),
 });
 
 /**

package/src/models/errors/apierror.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: e2280e075454
  */
 
 export class APIError extends Error {

package/src/models/errors/httpclienterrors.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6948de76af99
  */
 
 /**

package/src/models/errors/sdkvalidationerror.ts

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

package/src/models/explicitassetop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: dedbc3c2a2a8
  */
 
 import * as z from "zod";
@@ -30,7 +31,9 @@ export type ExplicitAssetAutoTranscription = {
 export const ExplicitAssetAutoTranscription$zodSchema: z.ZodType<
   ExplicitAssetAutoTranscription
 > = z.object({
-  translate: z.array(z.string()).optional(),
+  translate: z.array(z.string()).optional().describe(
+    "Array of target language codes for transcription translation.",
+  ),
 }).describe(
   "Configuration object for automatic video transcription with translation options.",
 );
@@ -116,48 +119,108 @@ export type ExplicitAssetRequestBody = {
 export const ExplicitAssetRequestBody$zodSchema: z.ZodType<
   ExplicitAssetRequestBody
 > = z.object({
-  accessibility_analysis: z.boolean().optional(),
-  api_key: z.string().optional(),
-  asset_folder: z.string().optional(),
-  async: z.boolean().optional(),
-  auto_chaptering: z.boolean().optional(),
+  accessibility_analysis: z.boolean().optional().describe(
+    "Whether to return return accessibility analysis values for the image.",
+  ),
+  api_key: z.string().optional().describe(
+    "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs.",
+  ),
+  asset_folder: z.string().optional().describe(
+    "The asset folder to assign to the asset.",
+  ),
+  async: z.boolean().optional().describe(
+    "When set to true, returns the uploaded asset's public_id immediately in the response, before the upload is completed (asynchronously). Default: false.\n",
+  ),
+  auto_chaptering: z.boolean().optional().describe(
+    "Whether to trigger automatic generation of video chapters. Chapters will be generated and saved as a .vtt file with -chapters appended to the public ID of the video. You can enable chapters as part of the Cloudinary Video Player. Relevant for videos only.",
+  ),
   auto_transcription: z.union([
     z.boolean(),
     z.lazy(() => ExplicitAssetAutoTranscription$zodSchema),
   ]).optional(),
-  callback: z.string().optional(),
-  cinemagraph_analysis: z.boolean().optional(),
-  colors: z.boolean().default(false),
-  context: z.string().optional(),
-  custom_coordinates: z.string().optional(),
-  display_name: z.string().optional(),
-  eager: z.string().optional(),
-  eager_async: z.boolean().optional(),
-  eager_notification_url: z.string().optional(),
-  face_coordinates: z.string().optional(),
-  faces: z.boolean().optional(),
-  headers: z.string().optional(),
-  invalidate: z.boolean().optional(),
-  media_metadata: z.boolean().optional(),
-  metadata: z.string().optional(),
-  moderation: z.string().optional(),
-  notification_url: z.string().optional(),
-  overwrite: z.boolean().optional(),
-  phash: z.boolean().optional(),
-  public_id: z.string(),
-  quality_analysis: z.boolean().optional(),
+  callback: z.string().optional().describe(
+    "A URL to redirect to after the upload/explicit is completed instead of returning the upload response.\nSigned upload result parameters are added to the callback URL. This parameter is ignored for XHR (Ajax XMLHttpRequest) or JavaScript Fetch API upload requests.\nNote: This parameter is relevant for direct uploads from a form in the browser. It is automatically set if you perform direct upload from the browser using Cloudinary's SDKs and the jQuery plugin.\n",
+  ),
+  cinemagraph_analysis: z.boolean().optional().describe(
+    "Whether to return a cinemagraph analysis value for the media asset between 0 and 1, where 0 means the asset is not a cinemagraph and 1 means the asset is a cinemagraph. Relevant for animated images and video only. A static image will return 0.",
+  ),
+  colors: z.boolean().default(false).describe(
+    "Whether to retrieve predominant colors & color histogram of the uploaded image. Note: If all returned colors are opaque, then 6-digit RGB hex values are returned. If one or more colors contain an alpha channel, then 8-digit RGBA hex quadruplet values are returned.",
+  ),
+  context: z.string().optional().describe(
+    "Key-value pairs of general textual context metadata to attach to the asset.",
+  ),
+  custom_coordinates: z.string().optional().describe(
+    "An array of coordinates for custom cropping.",
+  ),
+  display_name: z.string().optional().describe("A display name for the asset."),
+  eager: z.string().optional().describe(
+    "A list of transformations to eagerly generate for the asset. Accepts either a single transformation or a pipe-separated list of transformations.",
+  ),
+  eager_async: z.boolean().optional().describe(
+    "Whether to generate the eager transformations asynchronously in the background after the upload request is completed rather than before the upload is completed.",
+  ),
+  eager_notification_url: z.string().optional().describe(
+    "A URL to notify when eager transformations are completed.",
+  ),
+  face_coordinates: z.string().optional().describe(
+    "An array of coordinates representing detected faces in the asset, used for custom cropping or overlays.",
+  ),
+  faces: z.boolean().optional().describe(
+    "Whether to detect faces in the asset.",
+  ),
+  headers: z.string().optional().describe(
+    "An HTTP header or a list of headers lines for adding as response HTTP headers when delivering the asset to your users. Supported headers: Link, Authorization, X-Robots-Tag.\n",
+  ),
+  invalidate: z.boolean().optional().describe(
+    "Whether to invalidate CDN cache copies of a previously uploaded asset that shares the same public ID. Default: false.\n",
+  ),
+  media_metadata: z.boolean().optional().describe(
+    "Whether to return IPTC, XMP, and detailed Exif metadata of the uploaded asset in the response.\nSupported for images, video, and audio.\n- Returned metadata for images includes: PixelsPerUnitX, PixelsPerUnitY, PixelUnits, Colorspace, and DPI.\n- Returned metadata for audio and video includes: audio_codec, audio_bit_rate, audio_frequency, channels, channel_layout.\n- Additional metadata for video includes: pix_format, codec, level, profile, video_bit_rate, dar.\n",
+  ),
+  metadata: z.string().optional().describe(
+    "Structured metadata to attach to the asset based on the metadata fields defined for your account.",
+  ),
+  moderation: z.string().optional().describe(
+    "For all asset types, set to:\n- manual to add the uploaded asset to a list of pending assets that can be moderated using the Admin API or the Cloudinary Console.\n- perception_point to automatically moderate the uploaded asset using the Perception Point Malware Detection add-on.\n\nFor images only, set to:\n- webpurify to automatically moderate the uploaded image using the WebPurify Image Moderation add-on.\n- aws_rek to automatically moderate the uploaded image using the Amazon Rekognition AI Moderation add-on.\n- duplicate:<threshold> to detect if the same or a similar image already exists using the Cloudinary Duplicate Image Detection add-on. Set threshold to a float greater than 0 and less than or equal to 1.0 to specify how similar an image needs to be in order to be considered a duplicate. Set threshold to 0 to add an image to the index of images that are searched when duplicate detection is invoked for another image.\n\nFor videos only, set to:\n- aws_rek_video to automatically moderate the uploaded video using the Amazon Rekognition Video Moderation add-on.\n- google_video_moderation automatically moderate the uploaded video using the Google AI Video Moderation add-on.\n\nTo request multiple moderations in a single API call:\n- Send the desired list of moderations as a pipe-separated string with manual moderation, if relevant, being last.\n\nNote: Rejected assets are automatically invalidated on the CDN within approximately ten minutes.\n",
+  ),
+  notification_url: z.string().optional().describe(
+    "A URL to notify when the asset is ready.",
+  ),
+  overwrite: z.boolean().optional().describe(
+    "When applying eager for already existing video transformations, this setting indicates whether to force the existing derived video resources to be regenerated. Default for videos: false.\nNote: When specifying existing eager transformations for images, corresponding derived images are always regenerated.\n",
+  ),
+  phash: z.boolean().optional().describe(
+    "Whether to return the perceptual hash (pHash) on the uploaded image for image similarity detection.\n",
+  ),
+  public_id: z.string().describe(
+    "The public ID of the existing asset to apply operations on.",
+  ),
+  quality_analysis: z.boolean().optional().describe(
+    "Whether to return a quality analysis value for the image between 0 and 1, where 0 means the image is blurry and out of focus and 1 means the image is sharp and in focus. Relevant for images only.",
+  ),
   quality_override: z.union([
     z.string(),
     z.int(),
-  ]).optional(),
-  regions: z.string().optional(),
+  ]).optional().describe("Override the quality setting for this asset."),
+  regions: z.string().optional().describe("Regions to detect in the asset."),
   responsive_breakpoints: z.array(
     z.lazy(() => ExplicitAssetResponsiveBreakpoint$zodSchema),
-  ).optional(),
-  signature: z.string().optional(),
-  tags: z.string().optional(),
-  timestamp: z.int().optional(),
-  type: ArchiveStorageType$zodSchema.optional(),
+  ).optional().describe(
+    "Settings to automatically generate breakpoints for responsive images.",
+  ),
+  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",
+  ),
+  tags: z.string().optional().describe(
+    "A comma-separated list of tag names to assign to the asset.",
+  ),
+  timestamp: z.int().optional().describe(
+    "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs.",
+  ),
+  type: ArchiveStorageType$zodSchema.optional().describe(
+    "The storage type of resources to include in the archive.",
+  ),
 });
 
 export type ExplicitAssetRequest = {
@@ -168,7 +231,7 @@ export type ExplicitAssetRequest = {
 export const ExplicitAssetRequest$zodSchema: z.ZodType<ExplicitAssetRequest> = z
   .object({
     RequestBody: z.lazy(() => ExplicitAssetRequestBody$zodSchema),
-    resource_type: ResourceType$zodSchema,
+    resource_type: ResourceType$zodSchema.describe("The type of resource."),
   });
 
 export type ExplicitAssetResponse = ApiError | UploadResponse;

package/src/models/exploderesourceop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 5b8dcd950c40
  */
 
 import * as z from "zod";
@@ -47,14 +48,30 @@ export type ExplodeResourceRequestBody = {
 export const ExplodeResourceRequestBody$zodSchema: z.ZodType<
   ExplodeResourceRequestBody
 > = z.object({
-  api_key: z.string().optional(),
-  format: z.string().optional(),
-  notification_url: z.string().optional(),
-  public_id: z.string(),
-  signature: z.string().optional(),
-  timestamp: z.int().optional(),
-  transformation: z.string(),
-  type: StorageType$zodSchema.optional(),
+  api_key: z.string().optional().describe(
+    "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs.",
+  ),
+  format: z.string().optional().describe(
+    "The format for the generated derived images. Default: png",
+  ),
+  notification_url: z.string().optional().describe(
+    "The webhook URL to notify when the operation is complete.",
+  ),
+  public_id: z.string().describe(
+    "The public ID of the PDF or animated image to generate from.",
+  ),
+  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",
+  ),
+  timestamp: z.int().optional().describe(
+    "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs.",
+  ),
+  transformation: z.string().describe(
+    "The transformation to apply. Must contain exactly one pg_all transformation parameter.",
+  ),
+  type: StorageType$zodSchema.optional().describe(
+    "The storage type of the resource.",
+  ),
 });
 
 export type ExplodeResourceRequest = {
@@ -66,7 +83,9 @@ export const ExplodeResourceRequest$zodSchema: z.ZodType<
   ExplodeResourceRequest
 > = z.object({
   RequestBody: z.lazy(() => ExplodeResourceRequestBody$zodSchema),
-  resource_type: ExplodeResourceResourceType$zodSchema,
+  resource_type: ExplodeResourceResourceType$zodSchema.describe(
+    "The type of resource to explode. Only \"image\" is supported.",
+  ),
 });
 
 /**
@@ -95,8 +114,10 @@ export type ExplodeResourceResponseBody = {
 export const ExplodeResourceResponseBody$zodSchema: z.ZodType<
   ExplodeResourceResponseBody
 > = z.object({
-  batch_id: z.string().optional(),
-  status: ExplodeResourceStatus$zodSchema.optional(),
+  batch_id: z.string().optional().describe("The ID of the batch operation."),
+  status: ExplodeResourceStatus$zodSchema.optional().describe(
+    "The status of the explode operation.",
+  ),
 }).describe("Explode operation started successfully");
 
 export type ExplodeResourceResponse = ApiError | ExplodeResourceResponseBody;

package/src/models/extendedstoragetype.ts

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

package/src/models/fieldsspec.ts

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

package/src/models/folder.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a6cc95890d14
  */
 
 import * as z from "zod";
@@ -12,8 +13,10 @@ export type Folder = {
 };
 
 export const Folder$zodSchema: z.ZodType<Folder> = z.object({
-  created_at: z.iso.datetime({ offset: true }).optional(),
-  external_id: z.string(),
-  name: z.string(),
-  path: z.string(),
+  created_at: z.iso.datetime({ offset: true }).optional().describe(
+    "The timestamp when the folder was created.",
+  ),
+  external_id: z.string().describe("The unique identifier for the folder."),
+  name: z.string().describe("The name of the folder."),
+  path: z.string().describe("The full path of the folder."),
 });

package/src/models/folderrole.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 164b01265596
  */
 
 import * as z from "zod";
@@ -12,8 +13,12 @@ export type FolderRole = {
 };
 
 export const FolderRole$zodSchema: z.ZodType<FolderRole> = z.object({
-  description: z.string(),
-  id: z.string(),
-  inherited: z.boolean(),
-  name: z.string(),
+  description: z.string().describe(
+    "A summary of the permissions granted by this role.",
+  ),
+  id: z.string().describe("The unique identifier of the role."),
+  inherited: z.boolean().describe(
+    "Indicates whether this role is inherited from an ancestor folder. If false, it's assigned directly to the requested folder.",
+  ),
+  name: z.string().describe("The human-readable name of the role."),
 });

package/src/models/folderroleassignment.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b5abb32aaca9
  */
 
 import * as z from "zod";
@@ -15,8 +16,14 @@ export type FolderRoleAssignment = {
 
 export const FolderRoleAssignment$zodSchema: z.ZodType<FolderRoleAssignment> = z
   .object({
-    folder_id: z.string(),
-    id: z.string(),
-    roles: z.array(FolderRole$zodSchema),
-    type: PrincipalType$zodSchema,
+    folder_id: z.string().describe(
+      "The ID of the folder where this role assignment was defined, either the requested folder or one of its ancestor folders.",
+    ),
+    id: z.string().describe(
+      "The unique identifier of the principal. For `apiKey`, provide the API key value.",
+    ),
+    roles: z.array(FolderRole$zodSchema).describe(
+      "The roles assigned to this principal for this folder.",
+    ),
+    type: PrincipalType$zodSchema.describe("The type of principal."),
   });

package/src/models/folderrolesresponse.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a303d53836d0
  */
 
 import * as z from "zod";
@@ -16,6 +17,10 @@ export type FolderRolesResponse = {
 
 export const FolderRolesResponse$zodSchema: z.ZodType<FolderRolesResponse> = z
   .object({
-    permitted_roles: z.array(PermittedRole$zodSchema).optional(),
-    shared_with: z.array(FolderRoleAssignment$zodSchema).optional(),
+    permitted_roles: z.array(PermittedRole$zodSchema).optional().describe(
+      "The roles the authenticated user can assign on this folder. Users can assign only roles at or below their own permission level for this folder. Returned only when `include_assignable_roles` is true.",
+    ),
+    shared_with: z.array(FolderRoleAssignment$zodSchema).optional().describe(
+      "An array of principals (users, groups, or API keys) with their role assignments on this folder, including roles inherited from ancestor folders.",
+    ),
   });

package/src/models/folderslistresponse.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: dd1a90f3c5e6
  */
 
 import * as z from "zod";
@@ -13,7 +14,11 @@ export type FoldersListResponse = {
 
 export const FoldersListResponse$zodSchema: z.ZodType<FoldersListResponse> = z
   .object({
-    folders: z.array(Folder$zodSchema),
-    next_cursor: z.string().nullable(),
-    total_count: z.int(),
+    folders: z.array(Folder$zodSchema).describe(
+      "The root folders in the product environment.",
+    ),
+    next_cursor: z.string().nullable().describe(
+      "A cursor for pagination. Always null for root folders.",
+    ),
+    total_count: z.int().describe("The total number of root folders."),
   });

package/src/models/folderssearchresponse.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 587a44d93123
  */
 
 import * as z from "zod";
@@ -14,8 +15,14 @@ export type FoldersSearchResponse = {
 
 export const FoldersSearchResponse$zodSchema: z.ZodType<FoldersSearchResponse> =
   z.object({
-    folders: z.array(Folder$zodSchema),
-    next_cursor: z.string().nullable().optional(),
-    time: z.int(),
-    total_count: z.int(),
+    folders: z.array(Folder$zodSchema).describe(
+      "The folders matching the search.",
+    ),
+    next_cursor: z.string().nullable().optional().describe(
+      "A cursor for pagination.",
+    ),
+    time: z.int().describe("The time taken to execute the search (ms)."),
+    total_count: z.int().describe(
+      "The total number of folders matching the search.",
+    ),
   });