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

package/src/models/accesscontrolitem.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b3d5a7a42328
  */
 
 import * as z from "zod";
@@ -34,10 +35,18 @@ export type AccessControlItem = {
 
 export const AccessControlItem$zodSchema: z.ZodType<AccessControlItem> = z
   .object({
-    access_type: AccessType$zodSchema,
-    end: z.string().optional(),
-    key: z.string().optional(),
-    start: z.string().optional(),
+    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).",
+    ),
+    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).",
+    ),
   }).describe(
     "Access control rule that defines when and how the asset can be accessed.",
   );

package/src/models/apierror.ts

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

package/src/models/archiveresourcetype.ts

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

package/src/models/archivestoragetype.ts

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

package/src/models/assetrelationinfo.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f4e204f33aa2
  */
 
 import * as z from "zod";
@@ -43,8 +44,16 @@ export type AssetRelationInfo = {
 
 export const AssetRelationInfo$zodSchema: z.ZodType<AssetRelationInfo> = z
   .object({
-    asset: z.string().optional(),
-    code: Code$zodSchema.optional(),
-    message: z.string().optional(),
-    status: z.int().optional(),
+    asset: z.string().optional().describe(
+      "The identifier of the asset, either asset ID or public ID path.",
+    ),
+    code: Code$zodSchema.optional().describe(
+      "The code indicating the result of the operation.",
+    ),
+    message: z.string().optional().describe(
+      "The message indicating the result of the operation.",
+    ),
+    status: z.int().optional().describe(
+      "The HTTP status code indicating the result of the operation.",
+    ),
   });

package/src/models/assetrelationsdeleteresponse.ts

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

package/src/models/assetrelationsresponse.ts

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

package/src/models/assignfolderrolesop.ts

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

package/src/models/assignfolderrolesrequest.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f3016dd9de4e
  */
 
 import * as z from "zod";
@@ -12,8 +13,10 @@ import { PrincipalType, PrincipalType$zodSchema } from "./principaltype.js";
 export type Principal = { type: PrincipalType; id: string };
 
 export const Principal$zodSchema: z.ZodType<Principal> = z.object({
-  id: z.string(),
-  type: PrincipalType$zodSchema,
+  id: z.string().describe(
+    "The unique identifier of the principal. For `apiKey`, provide the API key value.",
+  ),
+  type: PrincipalType$zodSchema.describe("The type of principal."),
 }).describe(
   "The user, group, or API key whose role assignments are being modified.",
 );
@@ -46,7 +49,11 @@ export type AssignFolderRolesRequest = {
 export const AssignFolderRolesRequest$zodSchema: z.ZodType<
   AssignFolderRolesRequest
 > = z.object({
-  operation: Operation$zodSchema,
-  principal: z.lazy(() => Principal$zodSchema),
-  roles: z.array(z.string()),
+  operation: Operation$zodSchema.describe(
+    "The operation to perform on the principal’s role assignments. `add` grants the specified roles; `remove` revokes them.",
+  ),
+  principal: z.lazy(() => Principal$zodSchema).describe(
+    "The user, group, or API key whose role assignments are being modified.",
+  ),
+  roles: z.array(z.string()).describe("The role IDs to add or remove."),
 });

package/src/models/asyncuploadresponse.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2d92c68fa5b0
  */
 
 import * as z from "zod";
@@ -40,12 +41,22 @@ export type AsyncUploadResponse = {
 
 export const AsyncUploadResponse$zodSchema: z.ZodType<AsyncUploadResponse> = z
   .object({
-    batch_id: z.string(),
-    public_id: z.string().optional(),
-    requester_ip: z.string().optional(),
-    resource_type: ResourceType$zodSchema.optional(),
-    status: AsyncUploadResponseStatus$zodSchema,
-    type: StorageType$zodSchema,
+    batch_id: z.string().describe(
+      "A unique identifier for the asynchronous upload job.",
+    ),
+    public_id: z.string().optional().describe(
+      "The public ID assigned to the upload. May be omitted if it will be auto-generated.",
+    ),
+    requester_ip: z.string().optional().describe(
+      "The IP address of the requester. This is only included if a product environment has requester_ip tracking enabled.",
+    ),
+    resource_type: ResourceType$zodSchema.optional().describe(
+      "The type of resource.",
+    ),
+    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."),
   }).describe(
     "Response returned when an upload is processed asynchronously (async=true)",
   );

package/src/models/createassetrelationsbyassetidop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: bffd752a145b
  */
 
 import * as z from "zod";
@@ -27,7 +28,9 @@ export type CreateAssetRelationsByAssetIdRequestBody = {
 export const CreateAssetRelationsByAssetIdRequestBody$zodSchema: z.ZodType<
   CreateAssetRelationsByAssetIdRequestBody
 > = z.object({
-  assets_to_relate: z.array(z.string()),
+  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 = {

package/src/models/createassetrelationsbypublicidop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b52cfcc7e7b1
  */
 
 import * as z from "zod";
@@ -32,7 +33,9 @@ export type CreateAssetRelationsByPublicIdRequestBody = {
 export const CreateAssetRelationsByPublicIdRequestBody$zodSchema: z.ZodType<
   CreateAssetRelationsByPublicIdRequestBody
 > = z.object({
-  assets_to_relate: z.array(z.string()),
+  assets_to_relate: z.array(z.string()).describe(
+    "Relates the asset to all the other assets specified in this array of up to 10 assets, specified as resource_type/type/public_id.",
+  ),
 });
 
 export type CreateAssetRelationsByPublicIdRequest = {
@@ -49,8 +52,10 @@ export const CreateAssetRelationsByPublicIdRequest$zodSchema: z.ZodType<
     CreateAssetRelationsByPublicIdRequestBody$zodSchema
   ),
   public_id: z.string().describe("The public ID of the asset."),
-  resource_type: ResourceType$zodSchema,
-  type: StorageTypeParameter$zodSchema.default("upload"),
+  resource_type: ResourceType$zodSchema.describe("The type of resource."),
+  type: StorageTypeParameter$zodSchema.default("upload").describe(
+    "The delivery type of the asset.",
+  ),
 });
 
 export type CreateAssetRelationsByPublicIdResponse =

package/src/models/createfolderop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: cda9ad104697
  */
 
 import * as z from "zod";
@@ -33,9 +34,11 @@ export type CreateFolderResponseBody = {
 export const CreateFolderResponseBody$zodSchema: z.ZodType<
   CreateFolderResponseBody
 > = z.object({
-  name: z.string().optional(),
-  path: z.string().optional(),
-  success: z.boolean().optional(),
+  name: z.string().optional().describe("The name of the created folder"),
+  path: z.string().optional().describe("The path of the created folder"),
+  success: z.boolean().optional().describe(
+    "Whether the operation was successful",
+  ),
 }).describe("Folder created successfully");
 
 export type CreateFolderResponse = ApiError | CreateFolderResponseBody;

package/src/models/deleteassetrelationsbyassetidop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 212522b940e7
  */
 
 import * as z from "zod";
@@ -27,7 +28,9 @@ export type DeleteAssetRelationsByAssetIdRequestBody = {
 export const DeleteAssetRelationsByAssetIdRequestBody$zodSchema: z.ZodType<
   DeleteAssetRelationsByAssetIdRequestBody
 > = z.object({
-  assets_to_unrelate: z.array(z.string()),
+  assets_to_unrelate: z.array(z.string()).describe(
+    "Unrelates the asset from all the assets specified in this array of assets, specified by their asset IDs.",
+  ),
 });
 
 export type DeleteAssetRelationsByAssetIdRequest = {

package/src/models/deleteassetrelationsbypublicidop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 5e59aacafd23
  */
 
 import * as z from "zod";
@@ -32,7 +33,9 @@ export type DeleteAssetRelationsByPublicIdRequestBody = {
 export const DeleteAssetRelationsByPublicIdRequestBody$zodSchema: z.ZodType<
   DeleteAssetRelationsByPublicIdRequestBody
 > = z.object({
-  assets_to_unrelate: z.array(z.string()),
+  assets_to_unrelate: z.array(z.string()).describe(
+    "Unrelates the asset from all the assets specified in this array of assets, specified as resource_type/type/public_id.",
+  ),
 });
 
 export type DeleteAssetRelationsByPublicIdRequest = {
@@ -49,8 +52,10 @@ export const DeleteAssetRelationsByPublicIdRequest$zodSchema: z.ZodType<
     DeleteAssetRelationsByPublicIdRequestBody$zodSchema
   ),
   public_id: z.string().describe("The public ID of the asset."),
-  resource_type: ResourceType$zodSchema,
-  type: StorageTypeParameter$zodSchema.default("upload"),
+  resource_type: ResourceType$zodSchema.describe("The type of resource."),
+  type: StorageTypeParameter$zodSchema.default("upload").describe(
+    "The delivery type of the asset.",
+  ),
 });
 
 export type DeleteAssetRelationsByPublicIdResponse =

package/src/models/deletebackupversionsop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 99224d013801
  */
 
 import * as z from "zod";
@@ -19,7 +20,9 @@ export type DeleteBackupVersionsRequestBody = { version_ids: Array<string> };
 export const DeleteBackupVersionsRequestBody$zodSchema: z.ZodType<
   DeleteBackupVersionsRequestBody
 > = z.object({
-  version_ids: z.array(z.string()),
+  version_ids: z.array(z.string()).describe(
+    "The list of version IDs to delete from backup.",
+  ),
 });
 
 export type DeleteBackupVersionsRequest = {
@@ -42,8 +45,12 @@ export type Failure = {
 };
 
 export const Failure$zodSchema: z.ZodType<Failure> = z.object({
-  error: z.string().optional(),
-  version_id: z.string().optional(),
+  error: z.string().optional().describe(
+    "The error message explaining the failure.",
+  ),
+  version_id: z.string().optional().describe(
+    "The version ID that failed to delete.",
+  ),
 });
 
 /**
@@ -58,9 +65,13 @@ export type DeleteBackupVersionsResponseBody2 = {
 export const DeleteBackupVersionsResponseBody2$zodSchema: z.ZodType<
   DeleteBackupVersionsResponseBody2
 > = z.object({
-  asset_id: z.string(),
-  deleted_version_ids: z.array(z.string()),
-  failures: z.array(z.lazy(() => Failure$zodSchema)).optional(),
+  asset_id: z.string().describe("The asset ID of the resource."),
+  deleted_version_ids: z.array(z.string()).describe(
+    "The list of version IDs that were successfully deleted.",
+  ),
+  failures: z.array(z.lazy(() => Failure$zodSchema)).optional().describe(
+    "The list of version IDs that failed to delete with error messages.",
+  ),
 }).describe("Multi-status - some versions deleted successfully, others failed");
 
 /**
@@ -74,8 +85,10 @@ export type DeleteBackupVersionsResponseBody1 = {
 export const DeleteBackupVersionsResponseBody1$zodSchema: z.ZodType<
   DeleteBackupVersionsResponseBody1
 > = z.object({
-  asset_id: z.string(),
-  deleted_version_ids: z.array(z.string()),
+  asset_id: z.string().describe("The asset ID of the resource."),
+  deleted_version_ids: z.array(z.string()).describe(
+    "The list of version IDs that were successfully deleted.",
+  ),
 }).describe("Backup versions successfully deleted");
 
 export type DeleteBackupVersionsResponse =

package/src/models/deleteresourcebypublicidsrequestunion.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f609f3bcbc44
  */
 
 import * as z from "zod";
@@ -42,15 +43,31 @@ export type DeleteResourceByPublicIdsRequest3 = {
 export const DeleteResourceByPublicIdsRequest3$zodSchema: z.ZodType<
   DeleteResourceByPublicIdsRequest3
 > = z.object({
-  all: z.boolean(),
-  invalidate: z.boolean().default(false),
-  keep_original: z.boolean().default(false),
-  next_cursor: z.string().optional(),
-  prefix: z.string().optional(),
-  public_ids: z.array(z.string()).optional(),
+  all: z.boolean().describe(
+    "Delete all assets (of the relevant resource_type and type), including derived assets (up to a maximum of 1000 original resources).",
+  ),
+  invalidate: z.boolean().default(false).describe(
+    "Whether to also invalidate the copies of the resource on the CDN. It usually takes between a few seconds and a few minutes for the invalidation to fully propagate through the CDN. Default: false.",
+  ),
+  keep_original: z.boolean().default(false).describe(
+    "Whether to delete only the derived assets. Default: false.",
+  ),
+  next_cursor: z.string().optional().describe(
+    "(Only when deleting by prefix or all) When a deletion request has more than 1000 resources to delete, the response includes the partial boolean parameter set to true, as well as a next_cursor value. You can then specify this returned next_cursor value as a parameter of the following deletion request.",
+  ),
+  prefix: z.string().optional().describe(
+    "Delete all assets, including derived assets, where the public ID starts with the specified prefix (up to a maximum of 1000 original resources).",
+  ),
+  public_ids: z.array(z.string()).optional().describe(
+    "A list of public IDs of the resources to delete.",
+  ),
   resource_type: DeleteResourceByPublicIdsRequestResourceType3$zodSchema
-    .default("image"),
-  transformations: z.string().optional(),
+    .default("image").describe(
+      "The type of asset. Relevant as a parameter only when using the SDKs (the resource_type is included in the endpoint URL when using the REST API). Note: use video for all video and audio assets, such as .mp3. Default: image.",
+    ),
+  transformations: z.string().optional().describe(
+    "Only the derived assets matching this hash of transformation parameters will be deleted. You can include multiple transformations separated by a pipe character (|).",
+  ),
 });
 
 /**
@@ -90,15 +107,31 @@ export type DeleteResourceByPublicIdsRequest2 = {
 export const DeleteResourceByPublicIdsRequest2$zodSchema: z.ZodType<
   DeleteResourceByPublicIdsRequest2
 > = z.object({
-  all: z.boolean().optional(),
-  invalidate: z.boolean().default(false),
-  keep_original: z.boolean().default(false),
-  next_cursor: z.string().optional(),
-  prefix: z.string(),
-  public_ids: z.array(z.string()).optional(),
+  all: z.boolean().optional().describe(
+    "Delete all assets (of the relevant resource_type and type), including derived assets (up to a maximum of 1000 original resources).",
+  ),
+  invalidate: z.boolean().default(false).describe(
+    "Whether to also invalidate the copies of the resource on the CDN. It usually takes between a few seconds and a few minutes for the invalidation to fully propagate through the CDN. Default: false.",
+  ),
+  keep_original: z.boolean().default(false).describe(
+    "Whether to delete only the derived assets. Default: false.",
+  ),
+  next_cursor: z.string().optional().describe(
+    "(Only when deleting by prefix or all) When a deletion request has more than 1000 resources to delete, the response includes the partial boolean parameter set to true, as well as a next_cursor value. You can then specify this returned next_cursor value as a parameter of the following deletion request.",
+  ),
+  prefix: z.string().describe(
+    "Delete all assets, including derived assets, where the public ID starts with the specified prefix (up to a maximum of 1000 original resources).",
+  ),
+  public_ids: z.array(z.string()).optional().describe(
+    "A list of public IDs of the resources to delete.",
+  ),
   resource_type: DeleteResourceByPublicIdsRequestResourceType2$zodSchema
-    .default("image"),
-  transformations: z.string().optional(),
+    .default("image").describe(
+      "The type of asset. Relevant as a parameter only when using the SDKs (the resource_type is included in the endpoint URL when using the REST API). Note: use video for all video and audio assets, such as .mp3. Default: image.",
+    ),
+  transformations: z.string().optional().describe(
+    "Only the derived assets matching this hash of transformation parameters will be deleted. You can include multiple transformations separated by a pipe character (|).",
+  ),
 });
 
 /**
@@ -138,15 +171,31 @@ export type DeleteResourceByPublicIdsRequest1 = {
 export const DeleteResourceByPublicIdsRequest1$zodSchema: z.ZodType<
   DeleteResourceByPublicIdsRequest1
 > = z.object({
-  all: z.boolean().optional(),
-  invalidate: z.boolean().default(false),
-  keep_original: z.boolean().default(false),
-  next_cursor: z.string().optional(),
-  prefix: z.string().optional(),
-  public_ids: z.array(z.string()),
+  all: z.boolean().optional().describe(
+    "Delete all assets (of the relevant resource_type and type), including derived assets (up to a maximum of 1000 original resources).",
+  ),
+  invalidate: z.boolean().default(false).describe(
+    "Whether to also invalidate the copies of the resource on the CDN. It usually takes between a few seconds and a few minutes for the invalidation to fully propagate through the CDN. Default: false.",
+  ),
+  keep_original: z.boolean().default(false).describe(
+    "Whether to delete only the derived assets. Default: false.",
+  ),
+  next_cursor: z.string().optional().describe(
+    "(Only when deleting by prefix or all) When a deletion request has more than 1000 resources to delete, the response includes the partial boolean parameter set to true, as well as a next_cursor value. You can then specify this returned next_cursor value as a parameter of the following deletion request.",
+  ),
+  prefix: z.string().optional().describe(
+    "Delete all assets, including derived assets, where the public ID starts with the specified prefix (up to a maximum of 1000 original resources).",
+  ),
+  public_ids: z.array(z.string()).describe(
+    "A list of public IDs of the resources to delete.",
+  ),
   resource_type: DeleteResourceByPublicIdsRequestResourceType1$zodSchema
-    .default("image"),
-  transformations: z.string().optional(),
+    .default("image").describe(
+      "The type of asset. Relevant as a parameter only when using the SDKs (the resource_type is included in the endpoint URL when using the REST API). Note: use video for all video and audio assets, such as .mp3. Default: image.",
+    ),
+  transformations: z.string().optional().describe(
+    "Only the derived assets matching this hash of transformation parameters will be deleted. You can include multiple transformations separated by a pipe character (|).",
+  ),
 });
 
 export type DeleteResourceByPublicIdsRequestUnion =

package/src/models/deleteresourcesbypublicidop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: cf9aed5b5a91
  */
 
 import * as z from "zod";
@@ -36,8 +37,10 @@ export const DeleteResourcesByPublicIdRequest$zodSchema: z.ZodType<
 > = z.object({
   DeleteResourceByPublicIdsRequest:
     DeleteResourceByPublicIdsRequestUnion$zodSchema,
-  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.",
+  ),
 });
 
 /**

package/src/models/deriveddestroyop.ts

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

package/src/models/deriveddestroyrequest.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a8abf23f07f1
  */
 
 import * as z from "zod";
@@ -14,6 +15,10 @@ export type DerivedDestroyRequest = {
 
 export const DerivedDestroyRequest$zodSchema: z.ZodType<DerivedDestroyRequest> =
   z.object({
-    derived_resource_ids: z.array(z.string()),
-    invalidate: z.boolean().optional(),
+    derived_resource_ids: z.array(z.string()).describe(
+      "Array of derived resource IDs to delete specific derived resources",
+    ),
+    invalidate: z.boolean().optional().describe(
+      "Whether to invalidate the CDN cache for the deleted resources",
+    ),
   }).describe("Request parameters for deleting derived resources");

package/src/models/deriveddestroyresponse.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9a631d609b52
  */
 
 import * as z from "zod";
@@ -22,8 +23,12 @@ export type Invalidation = {
 };
 
 export const Invalidation$zodSchema: z.ZodType<Invalidation> = z.object({
-  took: z.number().optional(),
-  urls: z.array(z.string()).optional(),
+  took: z.number().optional().describe(
+    "Time taken for CDN invalidation in seconds",
+  ),
+  urls: z.array(z.string()).optional().describe(
+    "Array of URLs that were invalidated",
+  ),
 });
 
 /**
@@ -38,7 +43,11 @@ export type DerivedDestroyResponse = {
 export const DerivedDestroyResponse$zodSchema: z.ZodType<
   DerivedDestroyResponse
 > = z.object({
-  deleted: z.record(z.string(), Deleted$zodSchema).optional(),
+  deleted: z.record(z.string(), Deleted$zodSchema).optional().describe(
+    "Map of derived resource IDs to deletion status",
+  ),
   invalidation: z.lazy(() => Invalidation$zodSchema).optional(),
-  unauthorized: z.array(z.string()).optional(),
+  unauthorized: z.array(z.string()).optional().describe(
+    "Array of derived resource IDs that were not authorized to be deleted",
+  ),
 }).describe("Response for derived resource deletion");

package/src/models/destroyassetop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: e8b735f037d4
  */
 
 import * as z from "zod";
@@ -28,7 +29,7 @@ export const DestroyAssetRequest$zodSchema: z.ZodType<DestroyAssetRequest> = z
       "Whether to invalidate CDN cached copies of the asset",
     ),
     public_id: z.string().describe("The public ID of the asset."),
-    resource_type: ResourceType$zodSchema,
+    resource_type: ResourceType$zodSchema.describe("The type of resource."),
   });
 
 /**
@@ -58,7 +59,9 @@ export type DestroyAssetResponseBody = {
 export const DestroyAssetResponseBody$zodSchema: z.ZodType<
   DestroyAssetResponseBody
 > = z.object({
-  result: DestroyAssetResult$zodSchema.optional(),
+  result: DestroyAssetResult$zodSchema.optional().describe(
+    "Result of the deletion operation",
+  ),
 }).describe("Asset/resource destroyed successfully or not found");
 
 export type DestroyAssetResponse = ApiError | DestroyAssetResponseBody;

package/src/models/destroybyassetidop.ts

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

package/src/models/destroyfolderop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 729a07413143
  */
 
 import * as z from "zod";
@@ -29,7 +30,7 @@ export type DestroyFolderResponseBody = { deleted: Array<string> };
 export const DestroyFolderResponseBody$zodSchema: z.ZodType<
   DestroyFolderResponseBody
 > = z.object({
-  deleted: z.array(z.string()),
+  deleted: z.array(z.string()).describe("List of deleted folder paths"),
 }).describe("Folder deleted successfully");
 
 export type DestroyFolderResponse = DestroyFolderResponseBody | ApiError;