@cloudinary/asset-management-mcp 0.8.0 → 0.8.1

package/src/models/searchresponse.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: bbcd43bc9f51
  */
 
 import * as z from "zod";
@@ -99,7 +100,9 @@ export const SearchResponseAccessMode$zodSchema = z.enum([
 export type CreatedBy = { access_key?: string | undefined };
 
 export const CreatedBy$zodSchema: z.ZodType<CreatedBy> = z.object({
-  access_key: z.string().optional(),
+  access_key: z.string().optional().describe(
+    "The access key of the user who created the asset.",
+  ),
 }).describe("Information about who created the asset.");
 
 /**
@@ -108,7 +111,9 @@ export const CreatedBy$zodSchema: z.ZodType<CreatedBy> = z.object({
 export type UploadedBy = { access_key?: string | undefined };
 
 export const UploadedBy$zodSchema: z.ZodType<UploadedBy> = z.object({
-  access_key: z.string().optional(),
+  access_key: z.string().optional().describe(
+    "The access key of the user who uploaded the asset.",
+  ),
 }).describe("Information about who uploaded the asset.");
 
 /**
@@ -201,41 +206,82 @@ export type Resource = {
 };
 
 export const Resource$zodSchema: z.ZodType<Resource> = z.object({
-  access_control: z.array(AccessControlItem$zodSchema).nullable().optional(),
-  access_mode: SearchResponseAccessMode$zodSchema.optional(),
+  access_control: z.array(AccessControlItem$zodSchema).nullable().optional()
+    .describe("The access control settings for the asset."),
+  access_mode: SearchResponseAccessMode$zodSchema.optional().describe(
+    "The access mode of the asset.",
+  ),
   accessibility_analysis: z.lazy(() => AccessibilityAnalysis$zodSchema)
-    .nullable().optional(),
-  aspect_ratio: z.number().optional(),
-  asset_folder: z.string().optional(),
-  asset_id: z.string().optional(),
-  backup_bytes: z.int().optional(),
-  bytes: z.int().optional(),
-  context: z.lazy(() => SearchResponseContext$zodSchema).optional(),
-  created_at: z.iso.datetime({ offset: true }).optional(),
-  created_by: z.lazy(() => CreatedBy$zodSchema).nullable().optional(),
-  display_name: z.string().optional(),
-  etag: z.string().optional(),
-  filename: z.string().optional(),
-  format: z.string().optional(),
-  height: z.int().optional(),
-  image_analysis: z.lazy(() => ImageAnalysis$zodSchema).nullable().optional(),
+    .nullable().optional().describe("Results of accessibility analysis."),
+  aspect_ratio: z.number().optional().describe(
+    "The aspect ratio of the asset (width/height).",
+  ),
+  asset_folder: z.string().optional().describe(
+    "The folder where the asset is stored.",
+  ),
+  asset_id: z.string().optional().describe(
+    "The unique identifier of the asset.",
+  ),
+  backup_bytes: z.int().optional().describe(
+    "The size of the backup asset in bytes.",
+  ),
+  bytes: z.int().optional().describe("The size of the asset in bytes."),
+  context: z.lazy(() => SearchResponseContext$zodSchema).optional().describe(
+    "Custom context metadata associated with the asset.",
+  ),
+  created_at: z.iso.datetime({ offset: true }).optional().describe(
+    "The timestamp when the asset was created.",
+  ),
+  created_by: z.lazy(() => CreatedBy$zodSchema).nullable().optional().describe(
+    "Information about who created the asset.",
+  ),
+  display_name: z.string().optional().describe(
+    "The display name of the asset.",
+  ),
+  etag: z.string().optional().describe("The ETag of the asset."),
+  filename: z.string().optional().describe(
+    "The original filename of the asset.",
+  ),
+  format: z.string().optional().describe("The format of the asset."),
+  height: z.int().optional().describe("The height of the asset in pixels."),
+  image_analysis: z.lazy(() => ImageAnalysis$zodSchema).nullable().optional()
+    .describe("Results of image analysis."),
   image_metadata: z.lazy(() => SearchResponseImageMetadata$zodSchema).nullable()
-    .optional(),
-  metadata: z.lazy(() => Metadata$zodSchema).nullable().optional(),
-  pixels: z.int().optional(),
-  public_id: z.string().optional(),
+    .optional().describe("Technical metadata extracted from the image."),
+  metadata: z.lazy(() => Metadata$zodSchema).nullable().optional().describe(
+    "Structured metadata associated with the asset.",
+  ),
+  pixels: z.int().optional().describe(
+    "The total number of pixels in the asset.",
+  ),
+  public_id: z.string().optional().describe(
+    "The public identifier that is used to build the URL.",
+  ),
   quality_analysis: z.lazy(() => QualityAnalysis$zodSchema).nullable()
-    .optional(),
-  resource_type: SearchResponseResourceType$zodSchema.optional(),
-  secure_url: z.string().optional(),
-  status: SearchResponseStatus$zodSchema.optional(),
-  tags: z.array(z.string()).optional(),
-  type: SearchResponseType$zodSchema.optional(),
-  uploaded_at: z.iso.datetime({ offset: true }).optional(),
-  uploaded_by: z.lazy(() => UploadedBy$zodSchema).nullable().optional(),
-  url: z.string().optional(),
-  version: z.int().optional(),
-  width: z.int().optional(),
+    .optional().describe("Results of quality analysis."),
+  resource_type: SearchResponseResourceType$zodSchema.optional().describe(
+    "The type of resource.",
+  ),
+  secure_url: z.string().optional().describe(
+    "The HTTPS URL for accessing the asset.",
+  ),
+  status: SearchResponseStatus$zodSchema.optional().describe(
+    "The current status of the asset.",
+  ),
+  tags: z.array(z.string()).optional().describe(
+    "Tags associated with the asset.",
+  ),
+  type: SearchResponseType$zodSchema.optional().describe(
+    "The delivery type of the asset.",
+  ),
+  uploaded_at: z.iso.datetime({ offset: true }).optional().describe(
+    "The timestamp when the asset was uploaded.",
+  ),
+  uploaded_by: z.lazy(() => UploadedBy$zodSchema).nullable().optional()
+    .describe("Information about who uploaded the asset."),
+  url: z.string().optional().describe("The HTTP URL for accessing the asset."),
+  version: z.int().optional().describe("The version number of the asset."),
+  width: z.int().optional().describe("The width of the asset in pixels."),
 }).describe(
   "Resource fields that can be returned. All fields are optional and can be filtered using the fields parameter.",
 );
@@ -243,8 +289,8 @@ export const Resource$zodSchema: z.ZodType<Resource> = z.object({
 export type Value = { value?: string | undefined; count?: number | undefined };
 
 export const Value$zodSchema: z.ZodType<Value> = z.object({
-  count: z.int().optional(),
-  value: z.string().optional(),
+  count: z.int().optional().describe("The count of resources with this value"),
+  value: z.string().optional().describe("The value being aggregated"),
 });
 
 export type SearchResponseRange = {
@@ -255,9 +301,11 @@ export type SearchResponseRange = {
 
 export const SearchResponseRange$zodSchema: z.ZodType<SearchResponseRange> = z
   .object({
-    count: z.int().optional(),
-    from: z.number().optional(),
-    to: z.number().optional(),
+    count: z.int().optional().describe(
+      "The count of resources within this range",
+    ),
+    from: z.number().optional().describe("Start of the range (inclusive)"),
+    to: z.number().optional().describe("End of the range (exclusive)"),
   });
 
 /**
@@ -269,8 +317,13 @@ export type Aggregations = {
 };
 
 export const Aggregations$zodSchema: z.ZodType<Aggregations> = z.object({
-  ranges: z.array(z.lazy(() => SearchResponseRange$zodSchema)).optional(),
-  values: z.array(z.lazy(() => Value$zodSchema)).optional(),
+  ranges: z.array(z.lazy(() => SearchResponseRange$zodSchema)).optional()
+    .describe(
+      "Array of range-based aggregation results when using range aggregation (e.g., bytes, width, height, etc.)",
+    ),
+  values: z.array(z.lazy(() => Value$zodSchema)).optional().describe(
+    "Array of aggregation values when using simple aggregation (e.g., by format, resource_type, etc.)",
+  ),
 }).describe(
   "Aggregation results when the aggregate parameter is used in the request. Only included when aggregations are requested.",
 );
@@ -287,9 +340,19 @@ export type SearchResponse = {
 };
 
 export const SearchResponse$zodSchema: z.ZodType<SearchResponse> = z.object({
-  aggregations: z.lazy(() => Aggregations$zodSchema).optional(),
-  next_cursor: z.string().nullable().optional(),
-  resources: z.array(z.lazy(() => Resource$zodSchema)).optional(),
-  time: z.int().optional(),
-  total_count: z.int().optional(),
+  aggregations: z.lazy(() => Aggregations$zodSchema).optional().describe(
+    "Aggregation results when the aggregate parameter is used in the request. Only included when aggregations are requested.",
+  ),
+  next_cursor: z.string().nullable().optional().describe(
+    "A cursor for pagination. Only included when there are more results available.",
+  ),
+  resources: z.array(z.lazy(() => Resource$zodSchema)).optional().describe(
+    "The list of resources matching the search criteria. Can be empty if no results found.",
+  ),
+  time: z.int().optional().describe(
+    "The time taken to execute the search query in milliseconds.",
+  ),
+  total_count: z.int().optional().describe(
+    "The total number of resources matching the search criteria.",
+  ),
 }).describe("The response object returned by search operations.");

package/src/models/searchsortpair.ts

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

package/src/models/security.ts

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

package/src/models/showfolderop.ts

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

package/src/models/storagetype.ts

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

package/src/models/storagetypeparameter.ts

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

package/src/models/successresponse.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 5d95d1ff8650
  */
 
 import * as z from "zod";
@@ -7,5 +8,5 @@ import * as z from "zod";
 export type SuccessResponse = { success: boolean };
 
 export const SuccessResponse$zodSchema: z.ZodType<SuccessResponse> = z.object({
-  success: z.boolean(),
+  success: z.boolean().describe("Whether the operation was successful."),
 });

package/src/models/textop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a49c6a61da8e
  */
 
 import * as z from "zod";
@@ -122,18 +123,36 @@ export type TextRequestBody = {
 };
 
 export const TextRequestBody$zodSchema: z.ZodType<TextRequestBody> = z.object({
-  background: z.string().default("transparent"),
-  font_color: z.string().default("black"),
-  font_family: z.string().optional(),
-  font_size: z.int().default(12),
-  font_style: FontStyle$zodSchema.default("normal"),
-  font_weight: FontWeight$zodSchema.default("normal"),
-  line_spacing: z.int().optional(),
-  opacity: z.int().default(100),
-  public_id: z.string().optional(),
-  text: z.string(),
-  text_align: TextAlign$zodSchema.optional(),
-  text_decoration: TextDecoration$zodSchema.default("none"),
+  background: z.string().default("transparent").describe(
+    "Name or RGB representation of the background color (e.g., red or",
+  ),
+  font_color: z.string().default("black").describe(
+    "Name or RGB representation of the font's color (e.g., red or",
+  ),
+  font_family: z.string().optional().describe("The name of the font family."),
+  font_size: z.int().default(12).describe("Font size in points."),
+  font_style: FontStyle$zodSchema.default("normal").describe(
+    "Whether to use a normal or italic font.",
+  ),
+  font_weight: FontWeight$zodSchema.default("normal").describe(
+    "Whether to use a normal or bold font.",
+  ),
+  line_spacing: z.int().optional().describe(
+    "The spacing between lines of text in pixels.",
+  ),
+  opacity: z.int().default(100).describe(
+    "Text opacity value between 0 (invisible) and 100.",
+  ),
+  public_id: z.string().optional().describe(
+    "The identifier that is used for accessing the generated image. If not specified, a unique identifier is generated.",
+  ),
+  text: z.string().describe("The text string to generate an image for."),
+  text_align: TextAlign$zodSchema.optional().describe(
+    "Text alignment (left, center, right, justify).",
+  ),
+  text_decoration: TextDecoration$zodSchema.default("none").describe(
+    "Text decoration style.",
+  ),
 });
 
 export type TextRequest = {
@@ -143,7 +162,9 @@ export type TextRequest = {
 
 export const TextRequest$zodSchema: z.ZodType<TextRequest> = z.object({
   RequestBody: z.lazy(() => TextRequestBody$zodSchema),
-  resource_type: TextResourceType$zodSchema,
+  resource_type: TextResourceType$zodSchema.describe(
+    "The type of resource to create. Must be \"image\" for text generation.",
+  ),
 });
 
 export type Region = {};
@@ -199,30 +220,66 @@ export type TextResponseBody = {
 
 export const TextResponseBody$zodSchema: z.ZodType<TextResponseBody> = z.object(
   {
-    access_control: z.array(AccessControlItem$zodSchema).optional(),
-    access_mode: 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(),
-    etag: z.string().optional(),
-    format: z.string().optional(),
-    height: z.int().optional(),
-    info: z.lazy(() => TextInfo$zodSchema).optional(),
-    moderation: z.lazy(() => TextModeration$zodSchema).optional(),
-    pages: z.int().optional(),
-    placeholder: z.boolean().optional(),
-    public_id: z.string().optional(),
-    regions: z.array(z.lazy(() => Region$zodSchema)).optional(),
-    resource_type: z.string().optional(),
-    secure_url: z.string().optional(),
-    signature: 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(),
-    width: z.int().optional(),
+    access_control: z.array(AccessControlItem$zodSchema).optional().describe(
+      "Restricts access to the asset by specifying one or more access types.\nThe asset is restricted unless at least one listed access type is valid.\n",
+    ),
+    access_mode: z.string().optional().describe(
+      "The access mode of the asset.",
+    ),
+    asset_id: z.string().optional().describe(
+      "The unique identifier of the asset.",
+    ),
+    bytes: z.int().optional().describe("Size of the asset in bytes."),
+    created_at: z.iso.datetime({ offset: true }).optional().describe(
+      "The creation timestamp.",
+    ),
+    display_name: z.string().optional().describe(
+      "The display name of the asset.",
+    ),
+    etag: z.string().optional().describe("The ETag of the asset."),
+    format: z.string().optional().describe(
+      "The format of the generated image.",
+    ),
+    height: z.int().optional().describe(
+      "The height of the generated image in pixels.",
+    ),
+    info: z.lazy(() => TextInfo$zodSchema).optional().describe(
+      "Additional information about the asset.",
+    ),
+    moderation: z.lazy(() => TextModeration$zodSchema).optional().describe(
+      "Moderation information for the asset.",
+    ),
+    pages: z.int().optional().describe("Number of pages in the asset."),
+    placeholder: z.boolean().optional().describe(
+      "Whether the asset is a placeholder.",
+    ),
+    public_id: z.string().optional().describe(
+      "The public identifier of the asset.",
+    ),
+    regions: z.array(z.lazy(() => Region$zodSchema)).optional().describe(
+      "Region information for the asset.",
+    ),
+    resource_type: z.string().optional().describe(
+      "The type of resource (image).",
+    ),
+    secure_url: z.string().optional().describe(
+      "The HTTPS URL for accessing the asset.",
+    ),
+    signature: z.string().optional().describe("The signature for the asset."),
+    tags: z.array(z.string()).optional().describe(
+      "Array of tags assigned to the asset.",
+    ),
+    type: z.string().optional().describe("The storage type of the asset."),
+    url: z.string().optional().describe(
+      "The HTTP URL for accessing the asset.",
+    ),
+    version: z.int().optional().describe("The version number of the asset."),
+    version_id: z.string().optional().describe(
+      "The version identifier of the asset.",
+    ),
+    width: z.int().optional().describe(
+      "The width of the generated image in pixels.",
+    ),
   },
 ).describe("Text image created successfully");
 

package/src/models/thumbnail.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 5606c8e3b931
  */
 
 import * as z from "zod";
@@ -18,11 +19,17 @@ export type Thumbnail = {
 };
 
 export const Thumbnail$zodSchema: z.ZodType<Thumbnail> = z.object({
-  asset_id: z.string().optional(),
-  bounding_box: z.array(z.int()).optional(),
-  public_id: z.string().optional(),
-  resource_type: z.string().optional(),
-  type: z.string().optional(),
-  url: z.string().optional(),
-  version: z.int().optional(),
+  asset_id: z.string().optional().describe(
+    "The external ID of the asset used for the thumbnail.",
+  ),
+  bounding_box: z.array(z.int()).optional().describe(
+    "The bounding box coordinates [x, y, width, height] of the face in the asset.",
+  ),
+  public_id: z.string().optional().describe("The public ID of the asset."),
+  resource_type: z.string().optional().describe(
+    "The resource type of the asset.",
+  ),
+  type: z.string().optional().describe("The kind/type of the asset."),
+  url: z.string().optional().describe("The secure URL of the thumbnail asset."),
+  version: z.int().optional().describe("The version number of the asset."),
 }).describe("The thumbnail image for a person.");

package/src/models/updatefolderop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: c10dd50c3c15
  */
 
 import * as z from "zod";
@@ -19,7 +20,7 @@ export type UpdateFolderRequestBody = { to_folder: string };
 export const UpdateFolderRequestBody$zodSchema: z.ZodType<
   UpdateFolderRequestBody
 > = z.object({
-  to_folder: z.string(),
+  to_folder: z.string().describe("The new path for the folder."),
 });
 
 export type UpdateFolderRequest = {
@@ -36,15 +37,15 @@ export const UpdateFolderRequest$zodSchema: z.ZodType<UpdateFolderRequest> = z
 export type From = { name: string; path: string };
 
 export const From$zodSchema: z.ZodType<From> = z.object({
-  name: z.string(),
-  path: z.string(),
+  name: z.string().describe("The name of the source folder."),
+  path: z.string().describe("The full path of the source folder."),
 });
 
 export type To = { name: string; path: string };
 
 export const To$zodSchema: z.ZodType<To> = z.object({
-  name: z.string(),
-  path: z.string(),
+  name: z.string().describe("The name of the target folder."),
+  path: z.string().describe("The full path of the target folder."),
 });
 
 /**

package/src/models/updatepersonop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 5ddf6ef3582c
  */
 
 import * as z from "zod";
@@ -24,9 +25,13 @@ export type UpdatePersonRequestBody = {
 export const UpdatePersonRequestBody$zodSchema: z.ZodType<
   UpdatePersonRequestBody
 > = z.object({
-  name: z.string().optional(),
-  status: PersonStatus$zodSchema.optional(),
-  thumbnail_asset_id: z.string().optional(),
+  name: z.string().optional().describe(
+    "The display name for the person. Maximum 255 characters.",
+  ),
+  status: PersonStatus$zodSchema.optional().describe("The status of a person."),
+  thumbnail_asset_id: z.string().optional().describe(
+    "The external ID of an asset containing this person's face to use as the thumbnail.",
+  ),
 });
 
 export type UpdatePersonRequest = {
@@ -52,9 +57,11 @@ export type UpdatePersonResponseBody = {
 export const UpdatePersonResponseBody$zodSchema: z.ZodType<
   UpdatePersonResponseBody
 > = z.object({
-  name: z.string().optional(),
-  person_id: z.string().optional(),
-  status: PersonStatus$zodSchema.optional(),
+  name: z.string().optional().describe("The display name of the person."),
+  person_id: z.string().optional().describe(
+    "The unique identifier of the person.",
+  ),
+  status: PersonStatus$zodSchema.optional().describe("The status of a person."),
 }).describe("Person updated successfully");
 
 export type UpdatePersonResponse = ApiError | UpdatePersonResponseBody;

package/src/models/updateresourcebyassetidop.ts

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

package/src/models/updateresourcebypublicidop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3bb8de4a09c1
  */
 
 import * as z from "zod";
@@ -38,8 +39,10 @@ export const UpdateResourceByPublicIdRequest$zodSchema: z.ZodType<
 > = z.object({
   ResourceUpdateRequest: ResourceUpdateRequest$zodSchema,
   public_id: z.string().describe("The public ID of the asset."),
-  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.",
+  ),
 });
 
 export type UpdateResourceByPublicIdResponse = ApiError | Info;

package/src/models/uploadchunkop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 7e409cc80108
  */
 
 import * as z from "zod";
@@ -40,7 +41,9 @@ export const UploadChunkRequest$zodSchema: z.ZodType<UploadChunkRequest> = z
     contentRange: z.string().describe(
       "The range of bytes being uploaded in the current chunk, in the format \"bytes start-end/total\". For example, \"bytes 0-999999/3000000\" indicates the first 1MB chunk of a 3MB file.",
     ),
-    resource_type: UploadResourceType$zodSchema.default("auto"),
+    resource_type: UploadResourceType$zodSchema.default("auto").describe(
+      "The type of resource to upload:\n- \"image\" for uploading strictly images\n- \"video\" for uploading strictly videos\n- \"raw\" for uploading non-media files\n- \"auto\" for allowing Cloudinary to automatically detect the type of the uploaded file\n",
+    ),
     upload_request: UploadRequest$zodSchema,
     xUniqueUploadId: z.string().describe(
       "A unique identifier for the upload. Must be the same for all chunks of the same file.",

package/src/models/uploadnoresourcetypeop.ts

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

package/src/models/uploadop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: e50ad1ca57b4
  */
 
 import * as z from "zod";
@@ -29,7 +30,9 @@ export type UploadRequestRequest = {
 
 export const UploadRequestRequest$zodSchema: z.ZodType<UploadRequestRequest> = z
   .object({
-    resource_type: UploadResourceType$zodSchema.default("auto"),
+    resource_type: UploadResourceType$zodSchema.default("auto").describe(
+      "The type of resource to upload:\n- \"image\" for uploading strictly images\n- \"video\" for uploading strictly videos\n- \"raw\" for uploading non-media files\n- \"auto\" for allowing Cloudinary to automatically detect the type of the uploaded file\n",
+    ),
     upload_request: UploadRequest$zodSchema,
   });