@webitel/api-services 0.1.10 → 0.1.12

package/src/gen/cases/cases.zod.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v8.1.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * Webitel API
  * OpenAPI spec version: 24.04.0
@@ -54,13 +54,15 @@ export const SearchCasesResponse = zod
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Assignee responsible for resolving the case.'),
 						author: zod
 							.object({
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Author or reporter of the case.'),
 						closeReason: zod
 							.object({
 								id: zod.string().optional(),
@@ -72,7 +74,8 @@ export const SearchCasesResponse = zod
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Close reason group, immutable once set.'),
 						closeResult: zod.string().optional(),
 						comments: zod
 							.object({
@@ -85,7 +88,8 @@ export const SearchCasesResponse = zod
 														id: zod.string().optional(),
 														name: zod.string().optional(),
 													})
-													.optional(),
+													.optional()
+													.describe('Contact-author of the comment.'),
 												canEdit: zod
 													.boolean()
 													.optional()
@@ -109,7 +113,8 @@ export const SearchCasesResponse = zod
 														id: zod.string().optional(),
 														name: zod.string().optional(),
 													})
-													.optional(),
+													.optional()
+													.describe('User who created the comment.'),
 												edited: zod
 													.boolean()
 													.optional()
@@ -139,7 +144,8 @@ export const SearchCasesResponse = zod
 														id: zod.string().optional(),
 														name: zod.string().optional(),
 													})
-													.optional(),
+													.optional()
+													.describe('User who last updated the comment.'),
 												ver: zod
 													.number()
 													.optional()
@@ -158,7 +164,7 @@ export const SearchCasesResponse = zod
 								page: zod.string().optional().describe('Current page number.'),
 							})
 							.optional()
-							.describe('Contains a paginated list of comments.'),
+							.describe('List of comments on the case.'),
 						contactInfo: zod
 							.string()
 							.optional()
@@ -174,9 +180,10 @@ export const SearchCasesResponse = zod
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Creator of the case.'),
 						custom: zod
-							.object({})
+							.looseObject({})
 							.optional()
 							.describe('Custom data extension fields ..'),
 						dc: zod.string().optional(),
@@ -203,7 +210,8 @@ export const SearchCasesResponse = zod
 														name: zod.string().optional(),
 														type: zod.string().optional(),
 													})
-													.optional(),
+													.optional()
+													.describe('Creator of the file.'),
 												id: zod
 													.string()
 													.optional()
@@ -231,21 +239,23 @@ export const SearchCasesResponse = zod
 								page: zod.string().optional().describe('Current page number.'),
 							})
 							.optional()
-							.describe('Contains a list of case files with pagination.'),
+							.describe('List of attached files.'),
 						group: zod
 							.object({
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 								type: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Group associated with the case.'),
 						id: zod.string().optional().describe('Unique case ID.'),
 						impacted: zod
 							.object({
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Impacted contact (defaults to reporter if null).'),
 						links: zod
 							.object({
 								items: zod
@@ -282,7 +292,8 @@ export const SearchCasesResponse = zod
 								next: zod.boolean().optional(),
 								page: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('List of attached links.'),
 						name: zod
 							.string()
 							.optional()
@@ -316,7 +327,8 @@ export const SearchCasesResponse = zod
 									})
 									.optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Priority level of the case.'),
 						rating: zod.string().optional(),
 						ratingComment: zod.string().optional(),
 						reactedAt: zod.string().optional(),
@@ -337,7 +349,8 @@ export const SearchCasesResponse = zod
 														id: zod.string().optional(),
 														name: zod.string().optional(),
 													})
-													.optional(),
+													.optional()
+													.describe('User who created the relation.'),
 												etag: zod
 													.string()
 													.optional()
@@ -356,9 +369,7 @@ export const SearchCasesResponse = zod
 														ver: zod.number().optional(),
 													})
 													.optional()
-													.describe(
-														'RelatedCaseLookup is created specifically to include the subject field.',
-													),
+													.describe('Primary case details.'),
 												relatedCase: zod
 													.object({
 														color: zod.string().optional(),
@@ -369,9 +380,7 @@ export const SearchCasesResponse = zod
 														ver: zod.number().optional(),
 													})
 													.optional()
-													.describe(
-														'RelatedCaseLookup is created specifically to include the subject field.',
-													),
+													.describe('Related case details.'),
 												relationType: zod
 													.enum([
 														'RELATION_TYPE_UNSPECIFIED',
@@ -388,7 +397,7 @@ export const SearchCasesResponse = zod
 													.default(
 														searchCasesResponseItemsItemRelatedDataItemRelationTypeDefault,
 													)
-													.describe('Enum for relation types between cases.'),
+													.describe('Relation type between cases.'),
 												updatedAt: zod
 													.string()
 													.optional()
@@ -400,7 +409,8 @@ export const SearchCasesResponse = zod
 														id: zod.string().optional(),
 														name: zod.string().optional(),
 													})
-													.optional(),
+													.optional()
+													.describe('User who last updated the relation.'),
 												ver: zod
 													.number()
 													.optional()
@@ -421,13 +431,14 @@ export const SearchCasesResponse = zod
 								page: zod.string().optional().describe('Current page number.'),
 							})
 							.optional()
-							.describe('Paginated list of related cases.'),
+							.describe('List of related cases.'),
 						reporter: zod
 							.object({
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Reporter of the issue (null if anonymous).'),
 						resolvedAt: zod.string().optional(),
 						roleIds: zod.array(zod.string()).optional(),
 						service: zod
@@ -447,6 +458,28 @@ export const SearchCasesResponse = zod
 										name: zod.string().optional(),
 									})
 									.optional(),
+								defaultPriority: zod
+									.object({
+										color: zod.string().optional(),
+										createdAt: zod.string().optional(),
+										createdBy: zod
+											.object({
+												id: zod.string().optional(),
+												name: zod.string().optional(),
+											})
+											.optional(),
+										description: zod.string().optional(),
+										id: zod.string().optional(),
+										name: zod.string().optional(),
+										updatedAt: zod.string().optional(),
+										updatedBy: zod
+											.object({
+												id: zod.string().optional(),
+												name: zod.string().optional(),
+											})
+											.optional(),
+									})
+									.optional(),
 								description: zod.string().optional(),
 								group: zod
 									.object({
@@ -475,19 +508,22 @@ export const SearchCasesResponse = zod
 									})
 									.optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Service associated with the case.'),
 						sla: zod
 							.object({
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('SLA associated with the case.'),
 						slaCondition: zod
 							.object({
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('List of SLA conditions.'),
 						source: zod
 							.object({
 								id: zod.string().optional(),
@@ -507,13 +543,15 @@ export const SearchCasesResponse = zod
 										'Represents a source type for the source entity.\n\n - TYPE_UNSPECIFIED: Unspecified source type.\n - CALL: Phone call source type.\n - CHAT: Chat source type.\n - SOCIAL_MEDIA: Social media source type.\n - EMAIL: Email source type.\n - API: API source type.\n - MANUAL: Manual source type.',
 									),
 							})
-							.optional(),
+							.optional()
+							.describe('Source of the case.'),
 						status: zod
 							.object({
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Current status of the case.'),
 						statusCondition: zod
 							.object({
 								createdAt: zod.string().optional(),
@@ -537,7 +575,8 @@ export const SearchCasesResponse = zod
 									})
 									.optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Status condition from status lookup.'),
 						subject: zod.string().optional().describe('Subject of the case.'),
 						updatedAt: zod
 							.string()
@@ -550,7 +589,8 @@ export const SearchCasesResponse = zod
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Last updater of the case.'),
 						ver: zod
 							.number()
 							.optional()
@@ -593,19 +633,22 @@ export const CreateCaseBody = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Optional assignee ID.'),
 		closeReason: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Optional close information.'),
 		closeReasonGroup: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Optional close reason.'),
 		closeResult: zod
 			.string()
 			.optional()
@@ -615,7 +658,7 @@ export const CreateCaseBody = zod
 			.optional()
 			.describe('Optional contact information.'),
 		custom: zod
-			.object({})
+			.looseObject({})
 			.optional()
 			.describe('Custom data extension fields ..'),
 		description: zod
@@ -627,13 +670,15 @@ export const CreateCaseBody = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Optional group ID.'),
 		impacted: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Required impacted user ID (default: reporter).'),
 		links: zod
 			.array(
 				zod.object({
@@ -645,7 +690,10 @@ export const CreateCaseBody = zod
 							id: zod.string().optional(),
 							name: zod.string().optional(),
 						})
-						.optional(),
+						.optional()
+						.describe(
+							'Optional creator / updater ID. Use this to explicitly set the case creator / updater instead of deriving it from the auth token.',
+						),
 				}),
 			)
 			.optional()
@@ -655,7 +703,8 @@ export const CreateCaseBody = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Optional priority level.'),
 		rating: zod.string().optional().describe('API-only rating information.'),
 		ratingComment: zod
 			.string()
@@ -684,7 +733,7 @@ export const CreateCaseBody = zod
 								'RELATES_TO',
 							])
 							.default(createCaseBodyRelatedItemRelationTypeDefault)
-							.describe('Enum for relation types between cases.'),
+							.describe('Type of relation (e.g., duplicate, linked).'),
 					})
 					.describe('Structure for related cases input when creating a case.'),
 			)
@@ -695,25 +744,29 @@ export const CreateCaseBody = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Required reporter ID (if empty, anonymous contact).'),
 		service: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Service ID (affects many other readonly fields).'),
 		source: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Source of the case.'),
 		status: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Initial case status (default from lookup or UI).'),
 		statusCondition: zod
 			.object({
 				id: zod.string().optional(),
@@ -726,7 +779,10 @@ export const CreateCaseBody = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe(
+				'Optional creator / updater ID. Use this to explicitly set the case creator / updater instead of deriving it from the auth token.',
+			),
 	})
 	.describe('Input structure for creating a new case.');
 
@@ -740,13 +796,15 @@ export const CreateCaseResponse = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Assignee responsible for resolving the case.'),
 		author: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Author or reporter of the case.'),
 		closeReason: zod
 			.object({
 				id: zod.string().optional(),
@@ -758,7 +816,8 @@ export const CreateCaseResponse = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Close reason group, immutable once set.'),
 		closeResult: zod.string().optional(),
 		comments: zod
 			.object({
@@ -771,7 +830,8 @@ export const CreateCaseResponse = zod
 										id: zod.string().optional(),
 										name: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('Contact-author of the comment.'),
 								canEdit: zod
 									.boolean()
 									.optional()
@@ -793,7 +853,8 @@ export const CreateCaseResponse = zod
 										id: zod.string().optional(),
 										name: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('User who created the comment.'),
 								edited: zod
 									.boolean()
 									.optional()
@@ -821,7 +882,8 @@ export const CreateCaseResponse = zod
 										id: zod.string().optional(),
 										name: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('User who last updated the comment.'),
 								ver: zod
 									.number()
 									.optional()
@@ -840,7 +902,7 @@ export const CreateCaseResponse = zod
 				page: zod.string().optional().describe('Current page number.'),
 			})
 			.optional()
-			.describe('Contains a paginated list of comments.'),
+			.describe('List of comments on the case.'),
 		contactInfo: zod
 			.string()
 			.optional()
@@ -854,9 +916,10 @@ export const CreateCaseResponse = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Creator of the case.'),
 		custom: zod
-			.object({})
+			.looseObject({})
 			.optional()
 			.describe('Custom data extension fields ..'),
 		dc: zod.string().optional(),
@@ -883,7 +946,8 @@ export const CreateCaseResponse = zod
 										name: zod.string().optional(),
 										type: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('Creator of the file.'),
 								id: zod.string().optional().describe('Storage file ID.'),
 								mime: zod
 									.string()
@@ -905,21 +969,23 @@ export const CreateCaseResponse = zod
 				page: zod.string().optional().describe('Current page number.'),
 			})
 			.optional()
-			.describe('Contains a list of case files with pagination.'),
+			.describe('List of attached files.'),
 		group: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 				type: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Group associated with the case.'),
 		id: zod.string().optional().describe('Unique case ID.'),
 		impacted: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Impacted contact (defaults to reporter if null).'),
 		links: zod
 			.object({
 				items: zod
@@ -956,7 +1022,8 @@ export const CreateCaseResponse = zod
 				next: zod.boolean().optional(),
 				page: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('List of attached links.'),
 		name: zod
 			.string()
 			.optional()
@@ -990,7 +1057,8 @@ export const CreateCaseResponse = zod
 					})
 					.optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Priority level of the case.'),
 		rating: zod.string().optional(),
 		ratingComment: zod.string().optional(),
 		reactedAt: zod.string().optional(),
@@ -1011,7 +1079,8 @@ export const CreateCaseResponse = zod
 										id: zod.string().optional(),
 										name: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('User who created the relation.'),
 								etag: zod
 									.string()
 									.optional()
@@ -1030,9 +1099,7 @@ export const CreateCaseResponse = zod
 										ver: zod.number().optional(),
 									})
 									.optional()
-									.describe(
-										'RelatedCaseLookup is created specifically to include the subject field.',
-									),
+									.describe('Primary case details.'),
 								relatedCase: zod
 									.object({
 										color: zod.string().optional(),
@@ -1043,9 +1110,7 @@ export const CreateCaseResponse = zod
 										ver: zod.number().optional(),
 									})
 									.optional()
-									.describe(
-										'RelatedCaseLookup is created specifically to include the subject field.',
-									),
+									.describe('Related case details.'),
 								relationType: zod
 									.enum([
 										'RELATION_TYPE_UNSPECIFIED',
@@ -1060,7 +1125,7 @@ export const CreateCaseResponse = zod
 										'RELATES_TO',
 									])
 									.default(createCaseResponseRelatedDataItemRelationTypeDefault)
-									.describe('Enum for relation types between cases.'),
+									.describe('Relation type between cases.'),
 								updatedAt: zod
 									.string()
 									.optional()
@@ -1070,7 +1135,8 @@ export const CreateCaseResponse = zod
 										id: zod.string().optional(),
 										name: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('User who last updated the relation.'),
 								ver: zod
 									.number()
 									.optional()
@@ -1091,13 +1157,14 @@ export const CreateCaseResponse = zod
 				page: zod.string().optional().describe('Current page number.'),
 			})
 			.optional()
-			.describe('Paginated list of related cases.'),
+			.describe('List of related cases.'),
 		reporter: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Reporter of the issue (null if anonymous).'),
 		resolvedAt: zod.string().optional(),
 		roleIds: zod.array(zod.string()).optional(),
 		service: zod
@@ -1117,6 +1184,28 @@ export const CreateCaseResponse = zod
 						name: zod.string().optional(),
 					})
 					.optional(),
+				defaultPriority: zod
+					.object({
+						color: zod.string().optional(),
+						createdAt: zod.string().optional(),
+						createdBy: zod
+							.object({
+								id: zod.string().optional(),
+								name: zod.string().optional(),
+							})
+							.optional(),
+						description: zod.string().optional(),
+						id: zod.string().optional(),
+						name: zod.string().optional(),
+						updatedAt: zod.string().optional(),
+						updatedBy: zod
+							.object({
+								id: zod.string().optional(),
+								name: zod.string().optional(),
+							})
+							.optional(),
+					})
+					.optional(),
 				description: zod.string().optional(),
 				group: zod
 					.object({
@@ -1145,19 +1234,22 @@ export const CreateCaseResponse = zod
 					})
 					.optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Service associated with the case.'),
 		sla: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('SLA associated with the case.'),
 		slaCondition: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('List of SLA conditions.'),
 		source: zod
 			.object({
 				id: zod.string().optional(),
@@ -1177,13 +1269,15 @@ export const CreateCaseResponse = zod
 						'Represents a source type for the source entity.\n\n - TYPE_UNSPECIFIED: Unspecified source type.\n - CALL: Phone call source type.\n - CHAT: Chat source type.\n - SOCIAL_MEDIA: Social media source type.\n - EMAIL: Email source type.\n - API: API source type.\n - MANUAL: Manual source type.',
 					),
 			})
-			.optional(),
+			.optional()
+			.describe('Source of the case.'),
 		status: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Current status of the case.'),
 		statusCondition: zod
 			.object({
 				createdAt: zod.string().optional(),
@@ -1207,7 +1301,8 @@ export const CreateCaseResponse = zod
 					})
 					.optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Status condition from status lookup.'),
 		subject: zod.string().optional().describe('Subject of the case.'),
 		updatedAt: zod
 			.string()
@@ -1218,11 +1313,48 @@ export const CreateCaseResponse = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Last updater of the case.'),
 		ver: zod.number().optional().describe('Version number of the case.'),
 	})
 	.describe('Message representing a case.');
 
+/**
+ * @summary RPC method for exporting cases to CSV or XLSX format (server-side streaming).
+ */
+export const ExportCasesQueryParams = zod.object({
+	q: zod.string().optional(),
+	ids: zod.array(zod.string()).optional(),
+	sort: zod.string().optional(),
+	fields: zod.array(zod.string()).optional(),
+	filters: zod.array(zod.string()).optional(),
+	contactId: zod.string().optional(),
+	qin: zod.string().optional(),
+	filtersV1: zod.string().optional(),
+	format: zod.string().optional(),
+});
+
+export const ExportCasesResponse = zod.object({
+	error: zod
+		.object({
+			code: zod.number().optional(),
+			details: zod
+				.array(
+					zod.object({
+						'@type': zod.string().optional(),
+					}),
+				)
+				.optional(),
+			message: zod.string().optional(),
+		})
+		.optional(),
+	result: zod
+		.object({
+			data: zod.string().optional(),
+		})
+		.optional(),
+});
+
 /**
  * @summary RPC method for deleting an existing case by its etag.
  */
@@ -1247,13 +1379,15 @@ export const DeleteCaseResponse = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Assignee responsible for resolving the case.'),
 		author: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Author or reporter of the case.'),
 		closeReason: zod
 			.object({
 				id: zod.string().optional(),
@@ -1265,7 +1399,8 @@ export const DeleteCaseResponse = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Close reason group, immutable once set.'),
 		closeResult: zod.string().optional(),
 		comments: zod
 			.object({
@@ -1278,7 +1413,8 @@ export const DeleteCaseResponse = zod
 										id: zod.string().optional(),
 										name: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('Contact-author of the comment.'),
 								canEdit: zod
 									.boolean()
 									.optional()
@@ -1300,7 +1436,8 @@ export const DeleteCaseResponse = zod
 										id: zod.string().optional(),
 										name: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('User who created the comment.'),
 								edited: zod
 									.boolean()
 									.optional()
@@ -1328,7 +1465,8 @@ export const DeleteCaseResponse = zod
 										id: zod.string().optional(),
 										name: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('User who last updated the comment.'),
 								ver: zod
 									.number()
 									.optional()
@@ -1347,7 +1485,7 @@ export const DeleteCaseResponse = zod
 				page: zod.string().optional().describe('Current page number.'),
 			})
 			.optional()
-			.describe('Contains a paginated list of comments.'),
+			.describe('List of comments on the case.'),
 		contactInfo: zod
 			.string()
 			.optional()
@@ -1361,9 +1499,10 @@ export const DeleteCaseResponse = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Creator of the case.'),
 		custom: zod
-			.object({})
+			.looseObject({})
 			.optional()
 			.describe('Custom data extension fields ..'),
 		dc: zod.string().optional(),
@@ -1390,7 +1529,8 @@ export const DeleteCaseResponse = zod
 										name: zod.string().optional(),
 										type: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('Creator of the file.'),
 								id: zod.string().optional().describe('Storage file ID.'),
 								mime: zod
 									.string()
@@ -1412,21 +1552,23 @@ export const DeleteCaseResponse = zod
 				page: zod.string().optional().describe('Current page number.'),
 			})
 			.optional()
-			.describe('Contains a list of case files with pagination.'),
+			.describe('List of attached files.'),
 		group: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 				type: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Group associated with the case.'),
 		id: zod.string().optional().describe('Unique case ID.'),
 		impacted: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Impacted contact (defaults to reporter if null).'),
 		links: zod
 			.object({
 				items: zod
@@ -1463,7 +1605,8 @@ export const DeleteCaseResponse = zod
 				next: zod.boolean().optional(),
 				page: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('List of attached links.'),
 		name: zod
 			.string()
 			.optional()
@@ -1497,7 +1640,8 @@ export const DeleteCaseResponse = zod
 					})
 					.optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Priority level of the case.'),
 		rating: zod.string().optional(),
 		ratingComment: zod.string().optional(),
 		reactedAt: zod.string().optional(),
@@ -1518,7 +1662,8 @@ export const DeleteCaseResponse = zod
 										id: zod.string().optional(),
 										name: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('User who created the relation.'),
 								etag: zod
 									.string()
 									.optional()
@@ -1537,9 +1682,7 @@ export const DeleteCaseResponse = zod
 										ver: zod.number().optional(),
 									})
 									.optional()
-									.describe(
-										'RelatedCaseLookup is created specifically to include the subject field.',
-									),
+									.describe('Primary case details.'),
 								relatedCase: zod
 									.object({
 										color: zod.string().optional(),
@@ -1550,9 +1693,7 @@ export const DeleteCaseResponse = zod
 										ver: zod.number().optional(),
 									})
 									.optional()
-									.describe(
-										'RelatedCaseLookup is created specifically to include the subject field.',
-									),
+									.describe('Related case details.'),
 								relationType: zod
 									.enum([
 										'RELATION_TYPE_UNSPECIFIED',
@@ -1567,7 +1708,7 @@ export const DeleteCaseResponse = zod
 										'RELATES_TO',
 									])
 									.default(deleteCaseResponseRelatedDataItemRelationTypeDefault)
-									.describe('Enum for relation types between cases.'),
+									.describe('Relation type between cases.'),
 								updatedAt: zod
 									.string()
 									.optional()
@@ -1577,7 +1718,8 @@ export const DeleteCaseResponse = zod
 										id: zod.string().optional(),
 										name: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('User who last updated the relation.'),
 								ver: zod
 									.number()
 									.optional()
@@ -1598,13 +1740,14 @@ export const DeleteCaseResponse = zod
 				page: zod.string().optional().describe('Current page number.'),
 			})
 			.optional()
-			.describe('Paginated list of related cases.'),
+			.describe('List of related cases.'),
 		reporter: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Reporter of the issue (null if anonymous).'),
 		resolvedAt: zod.string().optional(),
 		roleIds: zod.array(zod.string()).optional(),
 		service: zod
@@ -1624,6 +1767,28 @@ export const DeleteCaseResponse = zod
 						name: zod.string().optional(),
 					})
 					.optional(),
+				defaultPriority: zod
+					.object({
+						color: zod.string().optional(),
+						createdAt: zod.string().optional(),
+						createdBy: zod
+							.object({
+								id: zod.string().optional(),
+								name: zod.string().optional(),
+							})
+							.optional(),
+						description: zod.string().optional(),
+						id: zod.string().optional(),
+						name: zod.string().optional(),
+						updatedAt: zod.string().optional(),
+						updatedBy: zod
+							.object({
+								id: zod.string().optional(),
+								name: zod.string().optional(),
+							})
+							.optional(),
+					})
+					.optional(),
 				description: zod.string().optional(),
 				group: zod
 					.object({
@@ -1652,19 +1817,22 @@ export const DeleteCaseResponse = zod
 					})
 					.optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Service associated with the case.'),
 		sla: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('SLA associated with the case.'),
 		slaCondition: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('List of SLA conditions.'),
 		source: zod
 			.object({
 				id: zod.string().optional(),
@@ -1684,13 +1852,15 @@ export const DeleteCaseResponse = zod
 						'Represents a source type for the source entity.\n\n - TYPE_UNSPECIFIED: Unspecified source type.\n - CALL: Phone call source type.\n - CHAT: Chat source type.\n - SOCIAL_MEDIA: Social media source type.\n - EMAIL: Email source type.\n - API: API source type.\n - MANUAL: Manual source type.',
 					),
 			})
-			.optional(),
+			.optional()
+			.describe('Source of the case.'),
 		status: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Current status of the case.'),
 		statusCondition: zod
 			.object({
 				createdAt: zod.string().optional(),
@@ -1714,7 +1884,8 @@ export const DeleteCaseResponse = zod
 					})
 					.optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Status condition from status lookup.'),
 		subject: zod.string().optional().describe('Subject of the case.'),
 		updatedAt: zod
 			.string()
@@ -1725,7 +1896,8 @@ export const DeleteCaseResponse = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Last updater of the case.'),
 		ver: zod.number().optional().describe('Version number of the case.'),
 	})
 	.describe('Message representing a case.');
@@ -1754,13 +1926,15 @@ export const LocateCaseResponse = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Assignee responsible for resolving the case.'),
 		author: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Author or reporter of the case.'),
 		closeReason: zod
 			.object({
 				id: zod.string().optional(),
@@ -1772,7 +1946,8 @@ export const LocateCaseResponse = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Close reason group, immutable once set.'),
 		closeResult: zod.string().optional(),
 		comments: zod
 			.object({
@@ -1785,7 +1960,8 @@ export const LocateCaseResponse = zod
 										id: zod.string().optional(),
 										name: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('Contact-author of the comment.'),
 								canEdit: zod
 									.boolean()
 									.optional()
@@ -1807,7 +1983,8 @@ export const LocateCaseResponse = zod
 										id: zod.string().optional(),
 										name: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('User who created the comment.'),
 								edited: zod
 									.boolean()
 									.optional()
@@ -1835,7 +2012,8 @@ export const LocateCaseResponse = zod
 										id: zod.string().optional(),
 										name: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('User who last updated the comment.'),
 								ver: zod
 									.number()
 									.optional()
@@ -1854,7 +2032,7 @@ export const LocateCaseResponse = zod
 				page: zod.string().optional().describe('Current page number.'),
 			})
 			.optional()
-			.describe('Contains a paginated list of comments.'),
+			.describe('List of comments on the case.'),
 		contactInfo: zod
 			.string()
 			.optional()
@@ -1868,9 +2046,10 @@ export const LocateCaseResponse = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Creator of the case.'),
 		custom: zod
-			.object({})
+			.looseObject({})
 			.optional()
 			.describe('Custom data extension fields ..'),
 		dc: zod.string().optional(),
@@ -1897,7 +2076,8 @@ export const LocateCaseResponse = zod
 										name: zod.string().optional(),
 										type: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('Creator of the file.'),
 								id: zod.string().optional().describe('Storage file ID.'),
 								mime: zod
 									.string()
@@ -1919,21 +2099,23 @@ export const LocateCaseResponse = zod
 				page: zod.string().optional().describe('Current page number.'),
 			})
 			.optional()
-			.describe('Contains a list of case files with pagination.'),
+			.describe('List of attached files.'),
 		group: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 				type: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Group associated with the case.'),
 		id: zod.string().optional().describe('Unique case ID.'),
 		impacted: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Impacted contact (defaults to reporter if null).'),
 		links: zod
 			.object({
 				items: zod
@@ -1970,7 +2152,8 @@ export const LocateCaseResponse = zod
 				next: zod.boolean().optional(),
 				page: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('List of attached links.'),
 		name: zod
 			.string()
 			.optional()
@@ -2004,7 +2187,8 @@ export const LocateCaseResponse = zod
 					})
 					.optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Priority level of the case.'),
 		rating: zod.string().optional(),
 		ratingComment: zod.string().optional(),
 		reactedAt: zod.string().optional(),
@@ -2025,7 +2209,8 @@ export const LocateCaseResponse = zod
 										id: zod.string().optional(),
 										name: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('User who created the relation.'),
 								etag: zod
 									.string()
 									.optional()
@@ -2044,9 +2229,7 @@ export const LocateCaseResponse = zod
 										ver: zod.number().optional(),
 									})
 									.optional()
-									.describe(
-										'RelatedCaseLookup is created specifically to include the subject field.',
-									),
+									.describe('Primary case details.'),
 								relatedCase: zod
 									.object({
 										color: zod.string().optional(),
@@ -2057,9 +2240,7 @@ export const LocateCaseResponse = zod
 										ver: zod.number().optional(),
 									})
 									.optional()
-									.describe(
-										'RelatedCaseLookup is created specifically to include the subject field.',
-									),
+									.describe('Related case details.'),
 								relationType: zod
 									.enum([
 										'RELATION_TYPE_UNSPECIFIED',
@@ -2074,7 +2255,7 @@ export const LocateCaseResponse = zod
 										'RELATES_TO',
 									])
 									.default(locateCaseResponseRelatedDataItemRelationTypeDefault)
-									.describe('Enum for relation types between cases.'),
+									.describe('Relation type between cases.'),
 								updatedAt: zod
 									.string()
 									.optional()
@@ -2084,7 +2265,8 @@ export const LocateCaseResponse = zod
 										id: zod.string().optional(),
 										name: zod.string().optional(),
 									})
-									.optional(),
+									.optional()
+									.describe('User who last updated the relation.'),
 								ver: zod
 									.number()
 									.optional()
@@ -2105,13 +2287,14 @@ export const LocateCaseResponse = zod
 				page: zod.string().optional().describe('Current page number.'),
 			})
 			.optional()
-			.describe('Paginated list of related cases.'),
+			.describe('List of related cases.'),
 		reporter: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Reporter of the issue (null if anonymous).'),
 		resolvedAt: zod.string().optional(),
 		roleIds: zod.array(zod.string()).optional(),
 		service: zod
@@ -2131,6 +2314,28 @@ export const LocateCaseResponse = zod
 						name: zod.string().optional(),
 					})
 					.optional(),
+				defaultPriority: zod
+					.object({
+						color: zod.string().optional(),
+						createdAt: zod.string().optional(),
+						createdBy: zod
+							.object({
+								id: zod.string().optional(),
+								name: zod.string().optional(),
+							})
+							.optional(),
+						description: zod.string().optional(),
+						id: zod.string().optional(),
+						name: zod.string().optional(),
+						updatedAt: zod.string().optional(),
+						updatedBy: zod
+							.object({
+								id: zod.string().optional(),
+								name: zod.string().optional(),
+							})
+							.optional(),
+					})
+					.optional(),
 				description: zod.string().optional(),
 				group: zod
 					.object({
@@ -2159,19 +2364,22 @@ export const LocateCaseResponse = zod
 					})
 					.optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Service associated with the case.'),
 		sla: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('SLA associated with the case.'),
 		slaCondition: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('List of SLA conditions.'),
 		source: zod
 			.object({
 				id: zod.string().optional(),
@@ -2191,13 +2399,15 @@ export const LocateCaseResponse = zod
 						'Represents a source type for the source entity.\n\n - TYPE_UNSPECIFIED: Unspecified source type.\n - CALL: Phone call source type.\n - CHAT: Chat source type.\n - SOCIAL_MEDIA: Social media source type.\n - EMAIL: Email source type.\n - API: API source type.\n - MANUAL: Manual source type.',
 					),
 			})
-			.optional(),
+			.optional()
+			.describe('Source of the case.'),
 		status: zod
 			.object({
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Current status of the case.'),
 		statusCondition: zod
 			.object({
 				createdAt: zod.string().optional(),
@@ -2221,7 +2431,8 @@ export const LocateCaseResponse = zod
 					})
 					.optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Status condition from status lookup.'),
 		subject: zod.string().optional().describe('Subject of the case.'),
 		updatedAt: zod
 			.string()
@@ -2232,7 +2443,8 @@ export const LocateCaseResponse = zod
 				id: zod.string().optional(),
 				name: zod.string().optional(),
 			})
-			.optional(),
+			.optional()
+			.describe('Last updater of the case.'),
 		ver: zod.number().optional().describe('Version number of the case.'),
 	})
 	.describe('Message representing a case.');
@@ -2276,7 +2488,10 @@ export const UpdateCase2Body = zod.object({
 		.optional(),
 	closeResult: zod.string().optional(),
 	contactInfo: zod.string().optional(),
-	custom: zod.object({}).optional().describe('Custom data extension fields ..'),
+	custom: zod
+		.looseObject({})
+		.optional()
+		.describe('Custom data extension fields ..'),
 	description: zod.string().optional(),
 	group: zod
 		.object({
@@ -2352,7 +2567,10 @@ export const UpdateCase2Body = zod.object({
 			id: zod.string().optional(),
 			name: zod.string().optional(),
 		})
-		.optional(),
+		.optional()
+		.describe(
+			'Optional creator / updater ID. Use this to explicitly set the case creator / updater instead of deriving it from the auth token.',
+		),
 });
 
 export const updateCase2ResponseCaseRelatedDataItemRelationTypeDefault = `RELATION_TYPE_UNSPECIFIED`;
@@ -2366,13 +2584,15 @@ export const UpdateCase2Response = zod.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Assignee responsible for resolving the case.'),
 			author: zod
 				.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Author or reporter of the case.'),
 			closeReason: zod
 				.object({
 					id: zod.string().optional(),
@@ -2384,7 +2604,8 @@ export const UpdateCase2Response = zod.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Close reason group, immutable once set.'),
 			closeResult: zod.string().optional(),
 			comments: zod
 				.object({
@@ -2397,7 +2618,8 @@ export const UpdateCase2Response = zod.object({
 											id: zod.string().optional(),
 											name: zod.string().optional(),
 										})
-										.optional(),
+										.optional()
+										.describe('Contact-author of the comment.'),
 									canEdit: zod
 										.boolean()
 										.optional()
@@ -2419,7 +2641,8 @@ export const UpdateCase2Response = zod.object({
 											id: zod.string().optional(),
 											name: zod.string().optional(),
 										})
-										.optional(),
+										.optional()
+										.describe('User who created the comment.'),
 									edited: zod
 										.boolean()
 										.optional()
@@ -2449,7 +2672,8 @@ export const UpdateCase2Response = zod.object({
 											id: zod.string().optional(),
 											name: zod.string().optional(),
 										})
-										.optional(),
+										.optional()
+										.describe('User who last updated the comment.'),
 									ver: zod
 										.number()
 										.optional()
@@ -2468,7 +2692,7 @@ export const UpdateCase2Response = zod.object({
 					page: zod.string().optional().describe('Current page number.'),
 				})
 				.optional()
-				.describe('Contains a paginated list of comments.'),
+				.describe('List of comments on the case.'),
 			contactInfo: zod
 				.string()
 				.optional()
@@ -2482,9 +2706,10 @@ export const UpdateCase2Response = zod.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Creator of the case.'),
 			custom: zod
-				.object({})
+				.looseObject({})
 				.optional()
 				.describe('Custom data extension fields ..'),
 			dc: zod.string().optional(),
@@ -2511,7 +2736,8 @@ export const UpdateCase2Response = zod.object({
 											name: zod.string().optional(),
 											type: zod.string().optional(),
 										})
-										.optional(),
+										.optional()
+										.describe('Creator of the file.'),
 									id: zod.string().optional().describe('Storage file ID.'),
 									mime: zod
 										.string()
@@ -2533,21 +2759,23 @@ export const UpdateCase2Response = zod.object({
 					page: zod.string().optional().describe('Current page number.'),
 				})
 				.optional()
-				.describe('Contains a list of case files with pagination.'),
+				.describe('List of attached files.'),
 			group: zod
 				.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 					type: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Group associated with the case.'),
 			id: zod.string().optional().describe('Unique case ID.'),
 			impacted: zod
 				.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Impacted contact (defaults to reporter if null).'),
 			links: zod
 				.object({
 					items: zod
@@ -2584,7 +2812,8 @@ export const UpdateCase2Response = zod.object({
 					next: zod.boolean().optional(),
 					page: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('List of attached links.'),
 			name: zod
 				.string()
 				.optional()
@@ -2618,7 +2847,8 @@ export const UpdateCase2Response = zod.object({
 						})
 						.optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Priority level of the case.'),
 			rating: zod.string().optional(),
 			ratingComment: zod.string().optional(),
 			reactedAt: zod.string().optional(),
@@ -2639,7 +2869,8 @@ export const UpdateCase2Response = zod.object({
 											id: zod.string().optional(),
 											name: zod.string().optional(),
 										})
-										.optional(),
+										.optional()
+										.describe('User who created the relation.'),
 									etag: zod
 										.string()
 										.optional()
@@ -2658,9 +2889,7 @@ export const UpdateCase2Response = zod.object({
 											ver: zod.number().optional(),
 										})
 										.optional()
-										.describe(
-											'RelatedCaseLookup is created specifically to include the subject field.',
-										),
+										.describe('Primary case details.'),
 									relatedCase: zod
 										.object({
 											color: zod.string().optional(),
@@ -2671,9 +2900,7 @@ export const UpdateCase2Response = zod.object({
 											ver: zod.number().optional(),
 										})
 										.optional()
-										.describe(
-											'RelatedCaseLookup is created specifically to include the subject field.',
-										),
+										.describe('Related case details.'),
 									relationType: zod
 										.enum([
 											'RELATION_TYPE_UNSPECIFIED',
@@ -2690,7 +2917,7 @@ export const UpdateCase2Response = zod.object({
 										.default(
 											updateCase2ResponseCaseRelatedDataItemRelationTypeDefault,
 										)
-										.describe('Enum for relation types between cases.'),
+										.describe('Relation type between cases.'),
 									updatedAt: zod
 										.string()
 										.optional()
@@ -2702,7 +2929,8 @@ export const UpdateCase2Response = zod.object({
 											id: zod.string().optional(),
 											name: zod.string().optional(),
 										})
-										.optional(),
+										.optional()
+										.describe('User who last updated the relation.'),
 									ver: zod
 										.number()
 										.optional()
@@ -2723,13 +2951,14 @@ export const UpdateCase2Response = zod.object({
 					page: zod.string().optional().describe('Current page number.'),
 				})
 				.optional()
-				.describe('Paginated list of related cases.'),
+				.describe('List of related cases.'),
 			reporter: zod
 				.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Reporter of the issue (null if anonymous).'),
 			resolvedAt: zod.string().optional(),
 			roleIds: zod.array(zod.string()).optional(),
 			service: zod
@@ -2749,6 +2978,28 @@ export const UpdateCase2Response = zod.object({
 							name: zod.string().optional(),
 						})
 						.optional(),
+					defaultPriority: zod
+						.object({
+							color: zod.string().optional(),
+							createdAt: zod.string().optional(),
+							createdBy: zod
+								.object({
+									id: zod.string().optional(),
+									name: zod.string().optional(),
+								})
+								.optional(),
+							description: zod.string().optional(),
+							id: zod.string().optional(),
+							name: zod.string().optional(),
+							updatedAt: zod.string().optional(),
+							updatedBy: zod
+								.object({
+									id: zod.string().optional(),
+									name: zod.string().optional(),
+								})
+								.optional(),
+						})
+						.optional(),
 					description: zod.string().optional(),
 					group: zod
 						.object({
@@ -2777,19 +3028,22 @@ export const UpdateCase2Response = zod.object({
 						})
 						.optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Service associated with the case.'),
 			sla: zod
 				.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('SLA associated with the case.'),
 			slaCondition: zod
 				.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('List of SLA conditions.'),
 			source: zod
 				.object({
 					id: zod.string().optional(),
@@ -2809,13 +3063,15 @@ export const UpdateCase2Response = zod.object({
 							'Represents a source type for the source entity.\n\n - TYPE_UNSPECIFIED: Unspecified source type.\n - CALL: Phone call source type.\n - CHAT: Chat source type.\n - SOCIAL_MEDIA: Social media source type.\n - EMAIL: Email source type.\n - API: API source type.\n - MANUAL: Manual source type.',
 						),
 				})
-				.optional(),
+				.optional()
+				.describe('Source of the case.'),
 			status: zod
 				.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Current status of the case.'),
 			statusCondition: zod
 				.object({
 					createdAt: zod.string().optional(),
@@ -2839,7 +3095,8 @@ export const UpdateCase2Response = zod.object({
 						})
 						.optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Status condition from status lookup.'),
 			subject: zod.string().optional().describe('Subject of the case.'),
 			updatedAt: zod
 				.string()
@@ -2850,7 +3107,8 @@ export const UpdateCase2Response = zod.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Last updater of the case.'),
 			ver: zod.number().optional().describe('Version number of the case.'),
 		})
 		.optional()
@@ -2905,7 +3163,10 @@ export const UpdateCaseBody = zod.object({
 		.optional(),
 	closeResult: zod.string().optional(),
 	contactInfo: zod.string().optional(),
-	custom: zod.object({}).optional().describe('Custom data extension fields ..'),
+	custom: zod
+		.looseObject({})
+		.optional()
+		.describe('Custom data extension fields ..'),
 	description: zod.string().optional(),
 	group: zod
 		.object({
@@ -2981,7 +3242,10 @@ export const UpdateCaseBody = zod.object({
 			id: zod.string().optional(),
 			name: zod.string().optional(),
 		})
-		.optional(),
+		.optional()
+		.describe(
+			'Optional creator / updater ID. Use this to explicitly set the case creator / updater instead of deriving it from the auth token.',
+		),
 });
 
 export const updateCaseResponseCaseRelatedDataItemRelationTypeDefault = `RELATION_TYPE_UNSPECIFIED`;
@@ -2995,13 +3259,15 @@ export const UpdateCaseResponse = zod.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Assignee responsible for resolving the case.'),
 			author: zod
 				.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Author or reporter of the case.'),
 			closeReason: zod
 				.object({
 					id: zod.string().optional(),
@@ -3013,7 +3279,8 @@ export const UpdateCaseResponse = zod.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Close reason group, immutable once set.'),
 			closeResult: zod.string().optional(),
 			comments: zod
 				.object({
@@ -3026,7 +3293,8 @@ export const UpdateCaseResponse = zod.object({
 											id: zod.string().optional(),
 											name: zod.string().optional(),
 										})
-										.optional(),
+										.optional()
+										.describe('Contact-author of the comment.'),
 									canEdit: zod
 										.boolean()
 										.optional()
@@ -3048,7 +3316,8 @@ export const UpdateCaseResponse = zod.object({
 											id: zod.string().optional(),
 											name: zod.string().optional(),
 										})
-										.optional(),
+										.optional()
+										.describe('User who created the comment.'),
 									edited: zod
 										.boolean()
 										.optional()
@@ -3078,7 +3347,8 @@ export const UpdateCaseResponse = zod.object({
 											id: zod.string().optional(),
 											name: zod.string().optional(),
 										})
-										.optional(),
+										.optional()
+										.describe('User who last updated the comment.'),
 									ver: zod
 										.number()
 										.optional()
@@ -3097,7 +3367,7 @@ export const UpdateCaseResponse = zod.object({
 					page: zod.string().optional().describe('Current page number.'),
 				})
 				.optional()
-				.describe('Contains a paginated list of comments.'),
+				.describe('List of comments on the case.'),
 			contactInfo: zod
 				.string()
 				.optional()
@@ -3111,9 +3381,10 @@ export const UpdateCaseResponse = zod.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Creator of the case.'),
 			custom: zod
-				.object({})
+				.looseObject({})
 				.optional()
 				.describe('Custom data extension fields ..'),
 			dc: zod.string().optional(),
@@ -3140,7 +3411,8 @@ export const UpdateCaseResponse = zod.object({
 											name: zod.string().optional(),
 											type: zod.string().optional(),
 										})
-										.optional(),
+										.optional()
+										.describe('Creator of the file.'),
 									id: zod.string().optional().describe('Storage file ID.'),
 									mime: zod
 										.string()
@@ -3162,21 +3434,23 @@ export const UpdateCaseResponse = zod.object({
 					page: zod.string().optional().describe('Current page number.'),
 				})
 				.optional()
-				.describe('Contains a list of case files with pagination.'),
+				.describe('List of attached files.'),
 			group: zod
 				.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 					type: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Group associated with the case.'),
 			id: zod.string().optional().describe('Unique case ID.'),
 			impacted: zod
 				.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Impacted contact (defaults to reporter if null).'),
 			links: zod
 				.object({
 					items: zod
@@ -3213,7 +3487,8 @@ export const UpdateCaseResponse = zod.object({
 					next: zod.boolean().optional(),
 					page: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('List of attached links.'),
 			name: zod
 				.string()
 				.optional()
@@ -3247,7 +3522,8 @@ export const UpdateCaseResponse = zod.object({
 						})
 						.optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Priority level of the case.'),
 			rating: zod.string().optional(),
 			ratingComment: zod.string().optional(),
 			reactedAt: zod.string().optional(),
@@ -3268,7 +3544,8 @@ export const UpdateCaseResponse = zod.object({
 											id: zod.string().optional(),
 											name: zod.string().optional(),
 										})
-										.optional(),
+										.optional()
+										.describe('User who created the relation.'),
 									etag: zod
 										.string()
 										.optional()
@@ -3287,9 +3564,7 @@ export const UpdateCaseResponse = zod.object({
 											ver: zod.number().optional(),
 										})
 										.optional()
-										.describe(
-											'RelatedCaseLookup is created specifically to include the subject field.',
-										),
+										.describe('Primary case details.'),
 									relatedCase: zod
 										.object({
 											color: zod.string().optional(),
@@ -3300,9 +3575,7 @@ export const UpdateCaseResponse = zod.object({
 											ver: zod.number().optional(),
 										})
 										.optional()
-										.describe(
-											'RelatedCaseLookup is created specifically to include the subject field.',
-										),
+										.describe('Related case details.'),
 									relationType: zod
 										.enum([
 											'RELATION_TYPE_UNSPECIFIED',
@@ -3319,7 +3592,7 @@ export const UpdateCaseResponse = zod.object({
 										.default(
 											updateCaseResponseCaseRelatedDataItemRelationTypeDefault,
 										)
-										.describe('Enum for relation types between cases.'),
+										.describe('Relation type between cases.'),
 									updatedAt: zod
 										.string()
 										.optional()
@@ -3331,7 +3604,8 @@ export const UpdateCaseResponse = zod.object({
 											id: zod.string().optional(),
 											name: zod.string().optional(),
 										})
-										.optional(),
+										.optional()
+										.describe('User who last updated the relation.'),
 									ver: zod
 										.number()
 										.optional()
@@ -3352,13 +3626,14 @@ export const UpdateCaseResponse = zod.object({
 					page: zod.string().optional().describe('Current page number.'),
 				})
 				.optional()
-				.describe('Paginated list of related cases.'),
+				.describe('List of related cases.'),
 			reporter: zod
 				.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Reporter of the issue (null if anonymous).'),
 			resolvedAt: zod.string().optional(),
 			roleIds: zod.array(zod.string()).optional(),
 			service: zod
@@ -3378,6 +3653,28 @@ export const UpdateCaseResponse = zod.object({
 							name: zod.string().optional(),
 						})
 						.optional(),
+					defaultPriority: zod
+						.object({
+							color: zod.string().optional(),
+							createdAt: zod.string().optional(),
+							createdBy: zod
+								.object({
+									id: zod.string().optional(),
+									name: zod.string().optional(),
+								})
+								.optional(),
+							description: zod.string().optional(),
+							id: zod.string().optional(),
+							name: zod.string().optional(),
+							updatedAt: zod.string().optional(),
+							updatedBy: zod
+								.object({
+									id: zod.string().optional(),
+									name: zod.string().optional(),
+								})
+								.optional(),
+						})
+						.optional(),
 					description: zod.string().optional(),
 					group: zod
 						.object({
@@ -3406,19 +3703,22 @@ export const UpdateCaseResponse = zod.object({
 						})
 						.optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Service associated with the case.'),
 			sla: zod
 				.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('SLA associated with the case.'),
 			slaCondition: zod
 				.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('List of SLA conditions.'),
 			source: zod
 				.object({
 					id: zod.string().optional(),
@@ -3438,13 +3738,15 @@ export const UpdateCaseResponse = zod.object({
 							'Represents a source type for the source entity.\n\n - TYPE_UNSPECIFIED: Unspecified source type.\n - CALL: Phone call source type.\n - CHAT: Chat source type.\n - SOCIAL_MEDIA: Social media source type.\n - EMAIL: Email source type.\n - API: API source type.\n - MANUAL: Manual source type.',
 						),
 				})
-				.optional(),
+				.optional()
+				.describe('Source of the case.'),
 			status: zod
 				.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Current status of the case.'),
 			statusCondition: zod
 				.object({
 					createdAt: zod.string().optional(),
@@ -3468,7 +3770,8 @@ export const UpdateCaseResponse = zod.object({
 						})
 						.optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Status condition from status lookup.'),
 			subject: zod.string().optional().describe('Subject of the case.'),
 			updatedAt: zod
 				.string()
@@ -3479,7 +3782,8 @@ export const UpdateCaseResponse = zod.object({
 					id: zod.string().optional(),
 					name: zod.string().optional(),
 				})
-				.optional(),
+				.optional()
+				.describe('Last updater of the case.'),
 			ver: zod.number().optional().describe('Version number of the case.'),
 		})
 		.optional()
@@ -3543,13 +3847,15 @@ export const SearchCases2Response = zod
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Assignee responsible for resolving the case.'),
 						author: zod
 							.object({
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Author or reporter of the case.'),
 						closeReason: zod
 							.object({
 								id: zod.string().optional(),
@@ -3561,7 +3867,8 @@ export const SearchCases2Response = zod
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Close reason group, immutable once set.'),
 						closeResult: zod.string().optional(),
 						comments: zod
 							.object({
@@ -3574,7 +3881,8 @@ export const SearchCases2Response = zod
 														id: zod.string().optional(),
 														name: zod.string().optional(),
 													})
-													.optional(),
+													.optional()
+													.describe('Contact-author of the comment.'),
 												canEdit: zod
 													.boolean()
 													.optional()
@@ -3598,7 +3906,8 @@ export const SearchCases2Response = zod
 														id: zod.string().optional(),
 														name: zod.string().optional(),
 													})
-													.optional(),
+													.optional()
+													.describe('User who created the comment.'),
 												edited: zod
 													.boolean()
 													.optional()
@@ -3628,7 +3937,8 @@ export const SearchCases2Response = zod
 														id: zod.string().optional(),
 														name: zod.string().optional(),
 													})
-													.optional(),
+													.optional()
+													.describe('User who last updated the comment.'),
 												ver: zod
 													.number()
 													.optional()
@@ -3647,7 +3957,7 @@ export const SearchCases2Response = zod
 								page: zod.string().optional().describe('Current page number.'),
 							})
 							.optional()
-							.describe('Contains a paginated list of comments.'),
+							.describe('List of comments on the case.'),
 						contactInfo: zod
 							.string()
 							.optional()
@@ -3663,9 +3973,10 @@ export const SearchCases2Response = zod
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Creator of the case.'),
 						custom: zod
-							.object({})
+							.looseObject({})
 							.optional()
 							.describe('Custom data extension fields ..'),
 						dc: zod.string().optional(),
@@ -3692,7 +4003,8 @@ export const SearchCases2Response = zod
 														name: zod.string().optional(),
 														type: zod.string().optional(),
 													})
-													.optional(),
+													.optional()
+													.describe('Creator of the file.'),
 												id: zod
 													.string()
 													.optional()
@@ -3720,21 +4032,23 @@ export const SearchCases2Response = zod
 								page: zod.string().optional().describe('Current page number.'),
 							})
 							.optional()
-							.describe('Contains a list of case files with pagination.'),
+							.describe('List of attached files.'),
 						group: zod
 							.object({
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 								type: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Group associated with the case.'),
 						id: zod.string().optional().describe('Unique case ID.'),
 						impacted: zod
 							.object({
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Impacted contact (defaults to reporter if null).'),
 						links: zod
 							.object({
 								items: zod
@@ -3771,7 +4085,8 @@ export const SearchCases2Response = zod
 								next: zod.boolean().optional(),
 								page: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('List of attached links.'),
 						name: zod
 							.string()
 							.optional()
@@ -3805,7 +4120,8 @@ export const SearchCases2Response = zod
 									})
 									.optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Priority level of the case.'),
 						rating: zod.string().optional(),
 						ratingComment: zod.string().optional(),
 						reactedAt: zod.string().optional(),
@@ -3826,7 +4142,8 @@ export const SearchCases2Response = zod
 														id: zod.string().optional(),
 														name: zod.string().optional(),
 													})
-													.optional(),
+													.optional()
+													.describe('User who created the relation.'),
 												etag: zod
 													.string()
 													.optional()
@@ -3845,9 +4162,7 @@ export const SearchCases2Response = zod
 														ver: zod.number().optional(),
 													})
 													.optional()
-													.describe(
-														'RelatedCaseLookup is created specifically to include the subject field.',
-													),
+													.describe('Primary case details.'),
 												relatedCase: zod
 													.object({
 														color: zod.string().optional(),
@@ -3858,9 +4173,7 @@ export const SearchCases2Response = zod
 														ver: zod.number().optional(),
 													})
 													.optional()
-													.describe(
-														'RelatedCaseLookup is created specifically to include the subject field.',
-													),
+													.describe('Related case details.'),
 												relationType: zod
 													.enum([
 														'RELATION_TYPE_UNSPECIFIED',
@@ -3877,7 +4190,7 @@ export const SearchCases2Response = zod
 													.default(
 														searchCases2ResponseItemsItemRelatedDataItemRelationTypeDefault,
 													)
-													.describe('Enum for relation types between cases.'),
+													.describe('Relation type between cases.'),
 												updatedAt: zod
 													.string()
 													.optional()
@@ -3889,7 +4202,8 @@ export const SearchCases2Response = zod
 														id: zod.string().optional(),
 														name: zod.string().optional(),
 													})
-													.optional(),
+													.optional()
+													.describe('User who last updated the relation.'),
 												ver: zod
 													.number()
 													.optional()
@@ -3910,13 +4224,14 @@ export const SearchCases2Response = zod
 								page: zod.string().optional().describe('Current page number.'),
 							})
 							.optional()
-							.describe('Paginated list of related cases.'),
+							.describe('List of related cases.'),
 						reporter: zod
 							.object({
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Reporter of the issue (null if anonymous).'),
 						resolvedAt: zod.string().optional(),
 						roleIds: zod.array(zod.string()).optional(),
 						service: zod
@@ -3936,6 +4251,28 @@ export const SearchCases2Response = zod
 										name: zod.string().optional(),
 									})
 									.optional(),
+								defaultPriority: zod
+									.object({
+										color: zod.string().optional(),
+										createdAt: zod.string().optional(),
+										createdBy: zod
+											.object({
+												id: zod.string().optional(),
+												name: zod.string().optional(),
+											})
+											.optional(),
+										description: zod.string().optional(),
+										id: zod.string().optional(),
+										name: zod.string().optional(),
+										updatedAt: zod.string().optional(),
+										updatedBy: zod
+											.object({
+												id: zod.string().optional(),
+												name: zod.string().optional(),
+											})
+											.optional(),
+									})
+									.optional(),
 								description: zod.string().optional(),
 								group: zod
 									.object({
@@ -3964,19 +4301,22 @@ export const SearchCases2Response = zod
 									})
 									.optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Service associated with the case.'),
 						sla: zod
 							.object({
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('SLA associated with the case.'),
 						slaCondition: zod
 							.object({
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('List of SLA conditions.'),
 						source: zod
 							.object({
 								id: zod.string().optional(),
@@ -3996,13 +4336,15 @@ export const SearchCases2Response = zod
 										'Represents a source type for the source entity.\n\n - TYPE_UNSPECIFIED: Unspecified source type.\n - CALL: Phone call source type.\n - CHAT: Chat source type.\n - SOCIAL_MEDIA: Social media source type.\n - EMAIL: Email source type.\n - API: API source type.\n - MANUAL: Manual source type.',
 									),
 							})
-							.optional(),
+							.optional()
+							.describe('Source of the case.'),
 						status: zod
 							.object({
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Current status of the case.'),
 						statusCondition: zod
 							.object({
 								createdAt: zod.string().optional(),
@@ -4026,7 +4368,8 @@ export const SearchCases2Response = zod
 									})
 									.optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Status condition from status lookup.'),
 						subject: zod.string().optional().describe('Subject of the case.'),
 						updatedAt: zod
 							.string()
@@ -4039,7 +4382,8 @@ export const SearchCases2Response = zod
 								id: zod.string().optional(),
 								name: zod.string().optional(),
 							})
-							.optional(),
+							.optional()
+							.describe('Last updater of the case.'),
 						ver: zod
 							.number()
 							.optional()