@wix/auto_sdk_online-programs_sections 1.0.13 → 1.0.14

package/build/internal/es/schemas.mjs

@@ -2,16 +2,18 @@
 import * as z from "zod";
 var CreateSectionRequest = z.object({
   section: z.object({
-    _id: z.string().describe("Program Section ID.").regex(
+    _id: z.string().describe("Section ID.").regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
     ).optional().nullable(),
     revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-      "Represents the current state of an item. Each time the item is modified, its `revision` changes by the server. for an update operation to succeed, you MUST pass the latest revision"
+      "Revision number, which increments by 1 each time the section is updated. To prevent conflicting changes, the current `revision` must be passed when updating or publishing the section."
     ).optional().nullable(),
-    _createdDate: z.date().describe("Represents the time this Section was created").optional().nullable(),
-    _updatedDate: z.date().describe("Represents the time this Section was last updated").optional().nullable(),
-    programId: z.string().describe("Program Id to which this section is assigned to.").regex(
+    _createdDate: z.date().describe("Date and time the section was created.").optional().nullable(),
+    _updatedDate: z.date().describe("Date and time the section was last updated.").optional().nullable(),
+    programId: z.string().describe(
+      "Program ID of the parent program. Provide it when creating a section. After creation, this value can't be changed."
+    ).regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
     ).optional(),
@@ -28,36 +30,44 @@ var CreateSectionRequest = z.object({
         z.object({ video: z.never().optional(), image: z.string() }),
         z.object({ image: z.never().optional(), video: z.string() })
       ])
-    ).describe("title, description and media content.").optional(),
+    ).describe(
+      "Section title and deprecated backward-compatibility content fields."
+    ).optional(),
     state: z.enum(["DRAFT", "PUBLISHED"]).optional(),
-    oldTotalSteps: z.number().int().describe("number of program steps in this section.").optional(),
-    totalSteps: z.number().int().describe("number of program steps in this section.").optional().nullable(),
+    oldTotalSteps: z.number().int().describe("Legacy total number of steps in the section.").optional(),
+    totalSteps: z.number().int().describe("Total number of steps in the section.").optional().nullable(),
     trialSection: z.boolean().describe(
-      "should we open this section as a trial content even though the owning program isn't purchased yet?"
+      "Whether participants can access the section as trial content before purchasing the parent program."
+    ).optional(),
+    ordering: z.number().describe(
+      "Position rank used to order sections within a program. To reorder sections, call Move Section."
     ).optional(),
-    ordering: z.number().describe("field for manual ordering of sections").optional(),
-    delayInDays: z.number().int().describe("open after defined number of days passed.").min(0).max(5e3).optional(),
+    delayInDays: z.number().int().describe(
+      "Number of days after the parent program starts before the section becomes available. Use `0` to make the section available immediately."
+    ).min(0).max(5e3).optional(),
     extendedFields: z.object({
       namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
         "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
       ).optional()
-    }).describe("extensible field").optional()
-  }).describe("Section to be created."),
+    }).describe("Custom field data for the section.").optional()
+  }).describe("Section to create. Must include `section.program_id`."),
   options: z.object({
     fields: z.array(z.enum(["TOTAL_STEPS"])).max(1).optional()
   }).optional()
 });
 var CreateSectionResponse = z.object({
-  _id: z.string().describe("Program Section ID.").regex(
+  _id: z.string().describe("Section ID.").regex(
     /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
     "Must be a valid GUID"
   ).optional().nullable(),
   revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-    "Represents the current state of an item. Each time the item is modified, its `revision` changes by the server. for an update operation to succeed, you MUST pass the latest revision"
+    "Revision number, which increments by 1 each time the section is updated. To prevent conflicting changes, the current `revision` must be passed when updating or publishing the section."
   ).optional().nullable(),
-  _createdDate: z.date().describe("Represents the time this Section was created").optional().nullable(),
-  _updatedDate: z.date().describe("Represents the time this Section was last updated").optional().nullable(),
-  programId: z.string().describe("Program Id to which this section is assigned to.").regex(
+  _createdDate: z.date().describe("Date and time the section was created.").optional().nullable(),
+  _updatedDate: z.date().describe("Date and time the section was last updated.").optional().nullable(),
+  programId: z.string().describe(
+    "Program ID of the parent program. Provide it when creating a section. After creation, this value can't be changed."
+  ).regex(
     /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
     "Must be a valid GUID"
   ).optional(),
@@ -71,34 +81,42 @@ var CreateSectionResponse = z.object({
       z.object({ video: z.never().optional(), image: z.string() }),
       z.object({ image: z.never().optional(), video: z.string() })
     ])
-  ).describe("title, description and media content.").optional(),
-  state: z.enum(["DRAFT", "PUBLISHED"]).describe("is this section published yet?").optional(),
-  oldTotalSteps: z.number().int().describe("number of program steps in this section.").optional(),
-  totalSteps: z.number().int().describe("number of program steps in this section.").optional().nullable(),
+  ).describe(
+    "Section title and deprecated backward-compatibility content fields."
+  ).optional(),
+  state: z.enum(["DRAFT", "PUBLISHED"]).describe("Publication state of the section.").optional(),
+  oldTotalSteps: z.number().int().describe("Legacy total number of steps in the section.").optional(),
+  totalSteps: z.number().int().describe("Total number of steps in the section.").optional().nullable(),
   trialSection: z.boolean().describe(
-    "should we open this section as a trial content even though the owning program isn't purchased yet?"
+    "Whether participants can access the section as trial content before purchasing the parent program."
+  ).optional(),
+  ordering: z.number().describe(
+    "Position rank used to order sections within a program. To reorder sections, call Move Section."
   ).optional(),
-  ordering: z.number().describe("field for manual ordering of sections").optional(),
-  delayInDays: z.number().int().describe("open after defined number of days passed.").min(0).max(5e3).optional(),
+  delayInDays: z.number().int().describe(
+    "Number of days after the parent program starts before the section becomes available. Use `0` to make the section available immediately."
+  ).min(0).max(5e3).optional(),
   extendedFields: z.object({
     namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
       "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
     ).optional()
-  }).describe("extensible field").optional()
+  }).describe("Custom field data for the section.").optional()
 });
 var BulkCreateSectionRequest = z.object({
   sections: z.array(
     z.object({
-      _id: z.string().describe("Program Section ID.").regex(
+      _id: z.string().describe("Section ID.").regex(
         /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
         "Must be a valid GUID"
       ).optional().nullable(),
       revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-        "Represents the current state of an item. Each time the item is modified, its `revision` changes by the server. for an update operation to succeed, you MUST pass the latest revision"
+        "Revision number, which increments by 1 each time the section is updated. To prevent conflicting changes, the current `revision` must be passed when updating or publishing the section."
       ).optional().nullable(),
-      _createdDate: z.date().describe("Represents the time this Section was created").optional().nullable(),
-      _updatedDate: z.date().describe("Represents the time this Section was last updated").optional().nullable(),
-      programId: z.string().describe("Program Id to which this section is assigned to.").regex(
+      _createdDate: z.date().describe("Date and time the section was created.").optional().nullable(),
+      _updatedDate: z.date().describe("Date and time the section was last updated.").optional().nullable(),
+      programId: z.string().describe(
+        "Program ID of the parent program. Provide it when creating a section. After creation, this value can't be changed."
+      ).regex(
         /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
         "Must be a valid GUID"
       ).optional(),
@@ -115,20 +133,26 @@ var BulkCreateSectionRequest = z.object({
           z.object({ video: z.never().optional(), image: z.string() }),
           z.object({ image: z.never().optional(), video: z.string() })
         ])
-      ).describe("title, description and media content.").optional(),
+      ).describe(
+        "Section title and deprecated backward-compatibility content fields."
+      ).optional(),
       state: z.enum(["DRAFT", "PUBLISHED"]).optional(),
-      oldTotalSteps: z.number().int().describe("number of program steps in this section.").optional(),
-      totalSteps: z.number().int().describe("number of program steps in this section.").optional().nullable(),
+      oldTotalSteps: z.number().int().describe("Legacy total number of steps in the section.").optional(),
+      totalSteps: z.number().int().describe("Total number of steps in the section.").optional().nullable(),
       trialSection: z.boolean().describe(
-        "should we open this section as a trial content even though the owning program isn't purchased yet?"
+        "Whether participants can access the section as trial content before purchasing the parent program."
+      ).optional(),
+      ordering: z.number().describe(
+        "Position rank used to order sections within a program. To reorder sections, call Move Section."
       ).optional(),
-      ordering: z.number().describe("field for manual ordering of sections").optional(),
-      delayInDays: z.number().int().describe("open after defined number of days passed.").min(0).max(5e3).optional(),
+      delayInDays: z.number().int().describe(
+        "Number of days after the parent program starts before the section becomes available. Use `0` to make the section available immediately."
+      ).min(0).max(5e3).optional(),
       extendedFields: z.object({
         namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
           "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
         ).optional()
-      }).describe("extensible field").optional()
+      }).describe("Custom field data for the section.").optional()
     })
   ).min(1).max(100),
   options: z.object({
@@ -153,18 +177,20 @@ var BulkCreateSectionResponse = z.object({
           description: z.string().describe("Description of the error.").optional(),
           data: z.record(z.string(), z.any()).describe("Data related to the error.").optional().nullable()
         }).describe("Details about the error in case of failure.").optional()
-      }).describe("item metadata").optional(),
+      }).describe("Metadata for the bulk operation result.").optional(),
       item: z.object({
-        _id: z.string().describe("Program Section ID.").regex(
+        _id: z.string().describe("Section ID.").regex(
           /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
           "Must be a valid GUID"
         ).optional().nullable(),
         revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-          "Represents the current state of an item. Each time the item is modified, its `revision` changes by the server. for an update operation to succeed, you MUST pass the latest revision"
+          "Revision number, which increments by 1 each time the section is updated. To prevent conflicting changes, the current `revision` must be passed when updating or publishing the section."
         ).optional().nullable(),
-        _createdDate: z.date().describe("Represents the time this Section was created").optional().nullable(),
-        _updatedDate: z.date().describe("Represents the time this Section was last updated").optional().nullable(),
-        programId: z.string().describe("Program Id to which this section is assigned to.").regex(
+        _createdDate: z.date().describe("Date and time the section was created.").optional().nullable(),
+        _updatedDate: z.date().describe("Date and time the section was last updated.").optional().nullable(),
+        programId: z.string().describe(
+          "Program ID of the parent program. Provide it when creating a section. After creation, this value can't be changed."
+        ).regex(
           /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
           "Must be a valid GUID"
         ).optional(),
@@ -181,140 +207,28 @@ var BulkCreateSectionResponse = z.object({
             z.object({ video: z.never().optional(), image: z.string() }),
             z.object({ image: z.never().optional(), video: z.string() })
           ])
-        ).describe("title, description and media content.").optional(),
-        state: z.enum(["DRAFT", "PUBLISHED"]).describe("is this section published yet?").optional(),
-        oldTotalSteps: z.number().int().describe("number of program steps in this section.").optional(),
-        totalSteps: z.number().int().describe("number of program steps in this section.").optional().nullable(),
-        trialSection: z.boolean().describe(
-          "should we open this section as a trial content even though the owning program isn't purchased yet?"
-        ).optional(),
-        ordering: z.number().describe("field for manual ordering of sections").optional(),
-        delayInDays: z.number().int().describe("open after defined number of days passed.").min(0).max(5e3).optional(),
-        extendedFields: z.object({
-          namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
-            "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
-          ).optional()
-        }).describe("extensible field").optional()
-      }).describe("created section").optional(),
-      action: z.enum(["UNKNOWN_ACTION_TYPE", "INSERT", "UPDATE", "DELETE"]).describe("indicator whether it was create or update").optional()
-    })
-  ).optional(),
-  bulkActionMetadata: z.object({
-    totalSuccesses: z.number().int().describe("Number of items that were successfully processed.").optional(),
-    totalFailures: z.number().int().describe("Number of items that couldn't be processed.").optional(),
-    undetailedFailures: z.number().int().describe(
-      "Number of failures without details because detailed failure threshold was exceeded."
-    ).optional()
-  }).describe("bulk metadata").optional()
-});
-var BulkCreateSectionMigrationRequest = z.object({
-  sections: z.array(
-    z.object({
-      _id: z.string().describe("Program Section ID.").regex(
-        /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
-        "Must be a valid GUID"
-      ).optional().nullable(),
-      revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-        "Represents the current state of an item. Each time the item is modified, its `revision` changes by the server. for an update operation to succeed, you MUST pass the latest revision"
-      ).optional().nullable(),
-      _createdDate: z.date().describe("Represents the time this Section was created").optional().nullable(),
-      _updatedDate: z.date().describe("Represents the time this Section was last updated").optional().nullable(),
-      programId: z.string().describe("Program Id to which this section is assigned to.").regex(
-        /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
-        "Must be a valid GUID"
-      ).optional(),
-      description: z.intersection(
-        z.object({
-          title: z.string().max(500).optional(),
-          details: z.string().max(1e7).optional().nullable()
-        }),
-        z.xor([
-          z.object({
-            image: z.never().optional(),
-            video: z.never().optional()
-          }),
-          z.object({ video: z.never().optional(), image: z.string() }),
-          z.object({ image: z.never().optional(), video: z.string() })
-        ])
-      ).describe("title, description and media content.").optional(),
-      state: z.enum(["DRAFT", "PUBLISHED"]).optional(),
-      oldTotalSteps: z.number().int().describe("number of program steps in this section.").optional(),
-      totalSteps: z.number().int().describe("number of program steps in this section.").optional().nullable(),
-      trialSection: z.boolean().describe(
-        "should we open this section as a trial content even though the owning program isn't purchased yet?"
-      ).optional(),
-      ordering: z.number().describe("field for manual ordering of sections").optional(),
-      delayInDays: z.number().int().describe("open after defined number of days passed.").min(0).max(5e3).optional(),
-      extendedFields: z.object({
-        namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
-          "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
-        ).optional()
-      }).describe("extensible field").optional()
-    })
-  ).min(1).max(100)
-});
-var BulkCreateSectionMigrationResponse = z.object({
-  results: z.array(
-    z.object({
-      itemMetadata: z.object({
-        _id: z.string().describe(
-          "Item ID. Should always be available, unless it's impossible (for example, when failing to create an item)."
-        ).optional().nullable(),
-        originalIndex: z.number().int().describe(
-          "Index of the item within the request array. Allows for correlation between request and response items."
-        ).optional(),
-        success: z.boolean().describe(
-          "Whether the requested action was successful for this item. When `false`, the `error` field is populated."
-        ).optional(),
-        error: z.object({
-          code: z.string().describe("Error code.").optional(),
-          description: z.string().describe("Description of the error.").optional(),
-          data: z.record(z.string(), z.any()).describe("Data related to the error.").optional().nullable()
-        }).describe("Details about the error in case of failure.").optional()
-      }).describe("item metadata").optional(),
-      item: z.object({
-        _id: z.string().describe("Program Section ID.").regex(
-          /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
-          "Must be a valid GUID"
-        ).optional().nullable(),
-        revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-          "Represents the current state of an item. Each time the item is modified, its `revision` changes by the server. for an update operation to succeed, you MUST pass the latest revision"
-        ).optional().nullable(),
-        _createdDate: z.date().describe("Represents the time this Section was created").optional().nullable(),
-        _updatedDate: z.date().describe("Represents the time this Section was last updated").optional().nullable(),
-        programId: z.string().describe("Program Id to which this section is assigned to.").regex(
-          /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
-          "Must be a valid GUID"
+        ).describe(
+          "Section title and deprecated backward-compatibility content fields."
         ).optional(),
-        description: z.intersection(
-          z.object({
-            title: z.string().max(500).optional(),
-            details: z.string().max(1e7).optional().nullable()
-          }),
-          z.xor([
-            z.object({
-              image: z.never().optional(),
-              video: z.never().optional()
-            }),
-            z.object({ video: z.never().optional(), image: z.string() }),
-            z.object({ image: z.never().optional(), video: z.string() })
-          ])
-        ).describe("title, description and media content.").optional(),
-        state: z.enum(["DRAFT", "PUBLISHED"]).describe("is this section published yet?").optional(),
-        oldTotalSteps: z.number().int().describe("number of program steps in this section.").optional(),
-        totalSteps: z.number().int().describe("number of program steps in this section.").optional().nullable(),
+        state: z.enum(["DRAFT", "PUBLISHED"]).describe("Publication state of the section.").optional(),
+        oldTotalSteps: z.number().int().describe("Legacy total number of steps in the section.").optional(),
+        totalSteps: z.number().int().describe("Total number of steps in the section.").optional().nullable(),
         trialSection: z.boolean().describe(
-          "should we open this section as a trial content even though the owning program isn't purchased yet?"
+          "Whether participants can access the section as trial content before purchasing the parent program."
         ).optional(),
-        ordering: z.number().describe("field for manual ordering of sections").optional(),
-        delayInDays: z.number().int().describe("open after defined number of days passed.").min(0).max(5e3).optional(),
+        ordering: z.number().describe(
+          "Position rank used to order sections within a program. To reorder sections, call Move Section."
+        ).optional(),
+        delayInDays: z.number().int().describe(
+          "Number of days after the parent program starts before the section becomes available. Use `0` to make the section available immediately."
+        ).min(0).max(5e3).optional(),
         extendedFields: z.object({
           namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
             "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
           ).optional()
-        }).describe("extensible field").optional()
-      }).describe("created section").optional(),
-      action: z.enum(["UNKNOWN_ACTION_TYPE", "INSERT", "UPDATE", "DELETE"]).describe("indicator whether it was create or update").optional()
+        }).describe("Custom field data for the section.").optional()
+      }).describe("Created section.").optional(),
+      action: z.enum(["UNKNOWN_ACTION_TYPE", "INSERT", "UPDATE", "DELETE"]).describe("Action associated with the bulk result.").optional()
     })
   ).optional(),
   bulkActionMetadata: z.object({
@@ -323,7 +237,7 @@ var BulkCreateSectionMigrationResponse = z.object({
     undetailedFailures: z.number().int().describe(
       "Number of failures without details because detailed failure threshold was exceeded."
     ).optional()
-  }).describe("bulk metadata").optional()
+  }).describe("Summary of the bulk create operation.").optional()
 });
 var GetSectionRequest = z.object({
   sectionId: z.string().describe("ID of the Section to retrieve.").regex(
@@ -336,16 +250,18 @@ var GetSectionRequest = z.object({
   }).optional()
 });
 var GetSectionResponse = z.object({
-  _id: z.string().describe("Program Section ID.").regex(
+  _id: z.string().describe("Section ID.").regex(
     /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
     "Must be a valid GUID"
   ).optional().nullable(),
   revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-    "Represents the current state of an item. Each time the item is modified, its `revision` changes by the server. for an update operation to succeed, you MUST pass the latest revision"
+    "Revision number, which increments by 1 each time the section is updated. To prevent conflicting changes, the current `revision` must be passed when updating or publishing the section."
   ).optional().nullable(),
-  _createdDate: z.date().describe("Represents the time this Section was created").optional().nullable(),
-  _updatedDate: z.date().describe("Represents the time this Section was last updated").optional().nullable(),
-  programId: z.string().describe("Program Id to which this section is assigned to.").regex(
+  _createdDate: z.date().describe("Date and time the section was created.").optional().nullable(),
+  _updatedDate: z.date().describe("Date and time the section was last updated.").optional().nullable(),
+  programId: z.string().describe(
+    "Program ID of the parent program. Provide it when creating a section. After creation, this value can't be changed."
+  ).regex(
     /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
     "Must be a valid GUID"
   ).optional(),
@@ -359,38 +275,46 @@ var GetSectionResponse = z.object({
       z.object({ video: z.never().optional(), image: z.string() }),
       z.object({ image: z.never().optional(), video: z.string() })
     ])
-  ).describe("title, description and media content.").optional(),
-  state: z.enum(["DRAFT", "PUBLISHED"]).describe("is this section published yet?").optional(),
-  oldTotalSteps: z.number().int().describe("number of program steps in this section.").optional(),
-  totalSteps: z.number().int().describe("number of program steps in this section.").optional().nullable(),
+  ).describe(
+    "Section title and deprecated backward-compatibility content fields."
+  ).optional(),
+  state: z.enum(["DRAFT", "PUBLISHED"]).describe("Publication state of the section.").optional(),
+  oldTotalSteps: z.number().int().describe("Legacy total number of steps in the section.").optional(),
+  totalSteps: z.number().int().describe("Total number of steps in the section.").optional().nullable(),
   trialSection: z.boolean().describe(
-    "should we open this section as a trial content even though the owning program isn't purchased yet?"
+    "Whether participants can access the section as trial content before purchasing the parent program."
   ).optional(),
-  ordering: z.number().describe("field for manual ordering of sections").optional(),
-  delayInDays: z.number().int().describe("open after defined number of days passed.").min(0).max(5e3).optional(),
+  ordering: z.number().describe(
+    "Position rank used to order sections within a program. To reorder sections, call Move Section."
+  ).optional(),
+  delayInDays: z.number().int().describe(
+    "Number of days after the parent program starts before the section becomes available. Use `0` to make the section available immediately."
+  ).min(0).max(5e3).optional(),
   extendedFields: z.object({
     namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
       "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
     ).optional()
-  }).describe("extensible field").optional()
+  }).describe("Custom field data for the section.").optional()
 });
 var UpdateSectionRequest = z.object({
-  _id: z.string().describe("Program Section ID.").regex(
+  _id: z.string().describe("Section ID.").regex(
     /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
     "Must be a valid GUID"
   ),
   options: z.object({
     section: z.object({
-      _id: z.string().describe("Program Section ID.").regex(
+      _id: z.string().describe("Section ID.").regex(
         /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
         "Must be a valid GUID"
       ).optional().nullable(),
       revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-        "Represents the current state of an item. Each time the item is modified, its `revision` changes by the server. for an update operation to succeed, you MUST pass the latest revision"
+        "Revision number, which increments by 1 each time the section is updated. To prevent conflicting changes, the current `revision` must be passed when updating or publishing the section."
       ),
-      _createdDate: z.date().describe("Represents the time this Section was created").optional().nullable(),
-      _updatedDate: z.date().describe("Represents the time this Section was last updated").optional().nullable(),
-      programId: z.string().describe("Program Id to which this section is assigned to.").regex(
+      _createdDate: z.date().describe("Date and time the section was created.").optional().nullable(),
+      _updatedDate: z.date().describe("Date and time the section was last updated.").optional().nullable(),
+      programId: z.string().describe(
+        "Program ID of the parent program. Provide it when creating a section. After creation, this value can't be changed."
+      ).regex(
         /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
         "Must be a valid GUID"
       ).optional(),
@@ -407,35 +331,45 @@ var UpdateSectionRequest = z.object({
           z.object({ video: z.never().optional(), image: z.string() }),
           z.object({ image: z.never().optional(), video: z.string() })
         ])
-      ).describe("title, description and media content.").optional(),
+      ).describe(
+        "Section title and deprecated backward-compatibility content fields."
+      ).optional(),
       state: z.enum(["DRAFT", "PUBLISHED"]).optional(),
-      oldTotalSteps: z.number().int().describe("number of program steps in this section.").optional(),
-      totalSteps: z.number().int().describe("number of program steps in this section.").optional().nullable(),
+      oldTotalSteps: z.number().int().describe("Legacy total number of steps in the section.").optional(),
+      totalSteps: z.number().int().describe("Total number of steps in the section.").optional().nullable(),
       trialSection: z.boolean().describe(
-        "should we open this section as a trial content even though the owning program isn't purchased yet?"
+        "Whether participants can access the section as trial content before purchasing the parent program."
       ).optional(),
-      ordering: z.number().describe("field for manual ordering of sections").optional(),
-      delayInDays: z.number().int().describe("open after defined number of days passed.").min(0).max(5e3).optional(),
+      ordering: z.number().describe(
+        "Position rank used to order sections within a program. To reorder sections, call Move Section."
+      ).optional(),
+      delayInDays: z.number().int().describe(
+        "Number of days after the parent program starts before the section becomes available. Use `0` to make the section available immediately."
+      ).min(0).max(5e3).optional(),
       extendedFields: z.object({
         namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
           "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
         ).optional()
-      }).describe("extensible field").optional()
-    }).describe("Section to be updated, may be partial.").optional(),
+      }).describe("Custom field data for the section.").optional()
+    }).describe(
+      "Section to update. Include `section.id`, `section.revision`, and the fields to update."
+    ).optional(),
     fields: z.array(z.enum(["TOTAL_STEPS"])).max(1).optional()
   }).optional()
 });
 var UpdateSectionResponse = z.object({
-  _id: z.string().describe("Program Section ID.").regex(
+  _id: z.string().describe("Section ID.").regex(
     /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
     "Must be a valid GUID"
   ).optional().nullable(),
   revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-    "Represents the current state of an item. Each time the item is modified, its `revision` changes by the server. for an update operation to succeed, you MUST pass the latest revision"
+    "Revision number, which increments by 1 each time the section is updated. To prevent conflicting changes, the current `revision` must be passed when updating or publishing the section."
   ).optional().nullable(),
-  _createdDate: z.date().describe("Represents the time this Section was created").optional().nullable(),
-  _updatedDate: z.date().describe("Represents the time this Section was last updated").optional().nullable(),
-  programId: z.string().describe("Program Id to which this section is assigned to.").regex(
+  _createdDate: z.date().describe("Date and time the section was created.").optional().nullable(),
+  _updatedDate: z.date().describe("Date and time the section was last updated.").optional().nullable(),
+  programId: z.string().describe(
+    "Program ID of the parent program. Provide it when creating a section. After creation, this value can't be changed."
+  ).regex(
     /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
     "Must be a valid GUID"
   ).optional(),
@@ -449,23 +383,29 @@ var UpdateSectionResponse = z.object({
       z.object({ video: z.never().optional(), image: z.string() }),
       z.object({ image: z.never().optional(), video: z.string() })
     ])
-  ).describe("title, description and media content.").optional(),
-  state: z.enum(["DRAFT", "PUBLISHED"]).describe("is this section published yet?").optional(),
-  oldTotalSteps: z.number().int().describe("number of program steps in this section.").optional(),
-  totalSteps: z.number().int().describe("number of program steps in this section.").optional().nullable(),
+  ).describe(
+    "Section title and deprecated backward-compatibility content fields."
+  ).optional(),
+  state: z.enum(["DRAFT", "PUBLISHED"]).describe("Publication state of the section.").optional(),
+  oldTotalSteps: z.number().int().describe("Legacy total number of steps in the section.").optional(),
+  totalSteps: z.number().int().describe("Total number of steps in the section.").optional().nullable(),
   trialSection: z.boolean().describe(
-    "should we open this section as a trial content even though the owning program isn't purchased yet?"
+    "Whether participants can access the section as trial content before purchasing the parent program."
   ).optional(),
-  ordering: z.number().describe("field for manual ordering of sections").optional(),
-  delayInDays: z.number().int().describe("open after defined number of days passed.").min(0).max(5e3).optional(),
+  ordering: z.number().describe(
+    "Position rank used to order sections within a program. To reorder sections, call Move Section."
+  ).optional(),
+  delayInDays: z.number().int().describe(
+    "Number of days after the parent program starts before the section becomes available. Use `0` to make the section available immediately."
+  ).min(0).max(5e3).optional(),
   extendedFields: z.object({
     namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
       "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
     ).optional()
-  }).describe("extensible field").optional()
+  }).describe("Custom field data for the section.").optional()
 });
 var DeleteSectionRequest = z.object({
-  sectionId: z.string().describe("Id of the Section to delete.").regex(
+  sectionId: z.string().describe("ID of the section to delete.").regex(
     /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
     "Must be a valid GUID"
   )
@@ -501,7 +441,7 @@ var QuerySectionsRequest = z.object({
   options: z.object({
     descriptionFieldSet: z.enum(["STANDARD", "EXTENDED"]).optional(),
     programId: z.string().describe(
-      "Program id to query sections. Not used anymore. Deprecated in favor of query filter param."
+      "Deprecated. Program ID used to scope the query. Use `query.filter` instead."
     ).optional(),
     fields: z.array(z.enum(["TOTAL_STEPS"])).max(1).optional()
   }).optional()
@@ -509,16 +449,18 @@ var QuerySectionsRequest = z.object({
 var QuerySectionsResponse = z.object({
   sections: z.array(
     z.object({
-      _id: z.string().describe("Program Section ID.").regex(
+      _id: z.string().describe("Section ID.").regex(
         /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
         "Must be a valid GUID"
       ).optional().nullable(),
       revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-        "Represents the current state of an item. Each time the item is modified, its `revision` changes by the server. for an update operation to succeed, you MUST pass the latest revision"
+        "Revision number, which increments by 1 each time the section is updated. To prevent conflicting changes, the current `revision` must be passed when updating or publishing the section."
       ).optional().nullable(),
-      _createdDate: z.date().describe("Represents the time this Section was created").optional().nullable(),
-      _updatedDate: z.date().describe("Represents the time this Section was last updated").optional().nullable(),
-      programId: z.string().describe("Program Id to which this section is assigned to.").regex(
+      _createdDate: z.date().describe("Date and time the section was created.").optional().nullable(),
+      _updatedDate: z.date().describe("Date and time the section was last updated.").optional().nullable(),
+      programId: z.string().describe(
+        "Program ID of the parent program. Provide it when creating a section. After creation, this value can't be changed."
+      ).regex(
         /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
         "Must be a valid GUID"
       ).optional(),
@@ -535,20 +477,26 @@ var QuerySectionsResponse = z.object({
           z.object({ video: z.never().optional(), image: z.string() }),
           z.object({ image: z.never().optional(), video: z.string() })
         ])
-      ).describe("title, description and media content.").optional(),
-      state: z.enum(["DRAFT", "PUBLISHED"]).describe("is this section published yet?").optional(),
-      oldTotalSteps: z.number().int().describe("number of program steps in this section.").optional(),
-      totalSteps: z.number().int().describe("number of program steps in this section.").optional().nullable(),
+      ).describe(
+        "Section title and deprecated backward-compatibility content fields."
+      ).optional(),
+      state: z.enum(["DRAFT", "PUBLISHED"]).describe("Publication state of the section.").optional(),
+      oldTotalSteps: z.number().int().describe("Legacy total number of steps in the section.").optional(),
+      totalSteps: z.number().int().describe("Total number of steps in the section.").optional().nullable(),
       trialSection: z.boolean().describe(
-        "should we open this section as a trial content even though the owning program isn't purchased yet?"
+        "Whether participants can access the section as trial content before purchasing the parent program."
+      ).optional(),
+      ordering: z.number().describe(
+        "Position rank used to order sections within a program. To reorder sections, call Move Section."
       ).optional(),
-      ordering: z.number().describe("field for manual ordering of sections").optional(),
-      delayInDays: z.number().int().describe("open after defined number of days passed.").min(0).max(5e3).optional(),
+      delayInDays: z.number().int().describe(
+        "Number of days after the parent program starts before the section becomes available. Use `0` to make the section available immediately."
+      ).min(0).max(5e3).optional(),
       extendedFields: z.object({
         namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
           "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
         ).optional()
-      }).describe("extensible field").optional()
+      }).describe("Custom field data for the section.").optional()
     })
   ).optional(),
   pagingMetadata: z.object({
@@ -566,10 +514,10 @@ var QuerySectionsResponse = z.object({
     hasNext: z.boolean().describe(
       "Whether there are more pages to retrieve following the current page.\n\n+ `true`: Another page of results can be retrieved.\n+ `false`: This is the last page."
     ).optional().nullable()
-  }).describe("Paging metadata").optional()
+  }).describe("Paging metadata.").optional()
 });
 var ListSectionsRequest = z.object({
-  programId: z.string().describe("Program id to list sections").regex(
+  programId: z.string().describe("Program ID to list sections for.").regex(
     /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
     "Must be a valid GUID"
   ),
@@ -581,16 +529,18 @@ var ListSectionsRequest = z.object({
 var ListSectionsResponse = z.object({
   sections: z.array(
     z.object({
-      _id: z.string().describe("Program Section ID.").regex(
+      _id: z.string().describe("Section ID.").regex(
         /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
         "Must be a valid GUID"
       ).optional().nullable(),
       revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-        "Represents the current state of an item. Each time the item is modified, its `revision` changes by the server. for an update operation to succeed, you MUST pass the latest revision"
+        "Revision number, which increments by 1 each time the section is updated. To prevent conflicting changes, the current `revision` must be passed when updating or publishing the section."
       ).optional().nullable(),
-      _createdDate: z.date().describe("Represents the time this Section was created").optional().nullable(),
-      _updatedDate: z.date().describe("Represents the time this Section was last updated").optional().nullable(),
-      programId: z.string().describe("Program Id to which this section is assigned to.").regex(
+      _createdDate: z.date().describe("Date and time the section was created.").optional().nullable(),
+      _updatedDate: z.date().describe("Date and time the section was last updated.").optional().nullable(),
+      programId: z.string().describe(
+        "Program ID of the parent program. Provide it when creating a section. After creation, this value can't be changed."
+      ).regex(
         /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
         "Must be a valid GUID"
       ).optional(),
@@ -607,25 +557,31 @@ var ListSectionsResponse = z.object({
           z.object({ video: z.never().optional(), image: z.string() }),
           z.object({ image: z.never().optional(), video: z.string() })
         ])
-      ).describe("title, description and media content.").optional(),
-      state: z.enum(["DRAFT", "PUBLISHED"]).describe("is this section published yet?").optional(),
-      oldTotalSteps: z.number().int().describe("number of program steps in this section.").optional(),
-      totalSteps: z.number().int().describe("number of program steps in this section.").optional().nullable(),
+      ).describe(
+        "Section title and deprecated backward-compatibility content fields."
+      ).optional(),
+      state: z.enum(["DRAFT", "PUBLISHED"]).describe("Publication state of the section.").optional(),
+      oldTotalSteps: z.number().int().describe("Legacy total number of steps in the section.").optional(),
+      totalSteps: z.number().int().describe("Total number of steps in the section.").optional().nullable(),
       trialSection: z.boolean().describe(
-        "should we open this section as a trial content even though the owning program isn't purchased yet?"
+        "Whether participants can access the section as trial content before purchasing the parent program."
+      ).optional(),
+      ordering: z.number().describe(
+        "Position rank used to order sections within a program. To reorder sections, call Move Section."
       ).optional(),
-      ordering: z.number().describe("field for manual ordering of sections").optional(),
-      delayInDays: z.number().int().describe("open after defined number of days passed.").min(0).max(5e3).optional(),
+      delayInDays: z.number().int().describe(
+        "Number of days after the parent program starts before the section becomes available. Use `0` to make the section available immediately."
+      ).min(0).max(5e3).optional(),
       extendedFields: z.object({
         namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
           "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
         ).optional()
-      }).describe("extensible field").optional()
+      }).describe("Custom field data for the section.").optional()
     })
   ).max(1e3).optional()
 });
 var CloneSectionRequest = z.object({
-  sectionId: z.string().describe("Section to clone").regex(
+  sectionId: z.string().describe("ID of the section to clone.").regex(
     /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
     "Must be a valid GUID"
   ),
@@ -635,16 +591,18 @@ var CloneSectionRequest = z.object({
 });
 var CloneSectionResponse = z.object({
   section: z.object({
-    _id: z.string().describe("Program Section ID.").regex(
+    _id: z.string().describe("Section ID.").regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
     ).optional().nullable(),
     revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-      "Represents the current state of an item. Each time the item is modified, its `revision` changes by the server. for an update operation to succeed, you MUST pass the latest revision"
+      "Revision number, which increments by 1 each time the section is updated. To prevent conflicting changes, the current `revision` must be passed when updating or publishing the section."
     ).optional().nullable(),
-    _createdDate: z.date().describe("Represents the time this Section was created").optional().nullable(),
-    _updatedDate: z.date().describe("Represents the time this Section was last updated").optional().nullable(),
-    programId: z.string().describe("Program Id to which this section is assigned to.").regex(
+    _createdDate: z.date().describe("Date and time the section was created.").optional().nullable(),
+    _updatedDate: z.date().describe("Date and time the section was last updated.").optional().nullable(),
+    programId: z.string().describe(
+      "Program ID of the parent program. Provide it when creating a section. After creation, this value can't be changed."
+    ).regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
     ).optional(),
@@ -661,50 +619,58 @@ var CloneSectionResponse = z.object({
         z.object({ video: z.never().optional(), image: z.string() }),
         z.object({ image: z.never().optional(), video: z.string() })
       ])
-    ).describe("title, description and media content.").optional(),
-    state: z.enum(["DRAFT", "PUBLISHED"]).describe("is this section published yet?").optional(),
-    oldTotalSteps: z.number().int().describe("number of program steps in this section.").optional(),
-    totalSteps: z.number().int().describe("number of program steps in this section.").optional().nullable(),
+    ).describe(
+      "Section title and deprecated backward-compatibility content fields."
+    ).optional(),
+    state: z.enum(["DRAFT", "PUBLISHED"]).describe("Publication state of the section.").optional(),
+    oldTotalSteps: z.number().int().describe("Legacy total number of steps in the section.").optional(),
+    totalSteps: z.number().int().describe("Total number of steps in the section.").optional().nullable(),
     trialSection: z.boolean().describe(
-      "should we open this section as a trial content even though the owning program isn't purchased yet?"
+      "Whether participants can access the section as trial content before purchasing the parent program."
+    ).optional(),
+    ordering: z.number().describe(
+      "Position rank used to order sections within a program. To reorder sections, call Move Section."
     ).optional(),
-    ordering: z.number().describe("field for manual ordering of sections").optional(),
-    delayInDays: z.number().int().describe("open after defined number of days passed.").min(0).max(5e3).optional(),
+    delayInDays: z.number().int().describe(
+      "Number of days after the parent program starts before the section becomes available. Use `0` to make the section available immediately."
+    ).min(0).max(5e3).optional(),
     extendedFields: z.object({
       namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
         "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
       ).optional()
-    }).describe("extensible field").optional()
-  }).describe("cloned section").optional()
+    }).describe("Custom field data for the section.").optional()
+  }).describe("Cloned section.").optional()
 });
 var MoveSectionRequest = z.object({
   options: z.object({
-    sectionId: z.string().describe("Section to move").regex(
+    sectionId: z.string().describe("ID of the section to move.").regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
     ).optional(),
     afterSectionId: z.string().describe(
-      'change section position to be after the specified section. If empty insert in the "0" position.'
+      "ID of the section that the moved section should be placed after. Leave empty to move the section to the beginning of the program."
     ).regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
     ).optional().nullable(),
-    revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe("section revision").optional(),
+    revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe("Current revision of the section.").optional(),
     fields: z.array(z.enum(["TOTAL_STEPS"])).max(1).optional()
   }).optional()
 });
 var MoveSectionResponse = z.object({
   section: z.object({
-    _id: z.string().describe("Program Section ID.").regex(
+    _id: z.string().describe("Section ID.").regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
     ).optional().nullable(),
     revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-      "Represents the current state of an item. Each time the item is modified, its `revision` changes by the server. for an update operation to succeed, you MUST pass the latest revision"
+      "Revision number, which increments by 1 each time the section is updated. To prevent conflicting changes, the current `revision` must be passed when updating or publishing the section."
     ).optional().nullable(),
-    _createdDate: z.date().describe("Represents the time this Section was created").optional().nullable(),
-    _updatedDate: z.date().describe("Represents the time this Section was last updated").optional().nullable(),
-    programId: z.string().describe("Program Id to which this section is assigned to.").regex(
+    _createdDate: z.date().describe("Date and time the section was created.").optional().nullable(),
+    _updatedDate: z.date().describe("Date and time the section was last updated.").optional().nullable(),
+    programId: z.string().describe(
+      "Program ID of the parent program. Provide it when creating a section. After creation, this value can't be changed."
+    ).regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
     ).optional(),
@@ -721,44 +687,52 @@ var MoveSectionResponse = z.object({
         z.object({ video: z.never().optional(), image: z.string() }),
         z.object({ image: z.never().optional(), video: z.string() })
       ])
-    ).describe("title, description and media content.").optional(),
-    state: z.enum(["DRAFT", "PUBLISHED"]).describe("is this section published yet?").optional(),
-    oldTotalSteps: z.number().int().describe("number of program steps in this section.").optional(),
-    totalSteps: z.number().int().describe("number of program steps in this section.").optional().nullable(),
+    ).describe(
+      "Section title and deprecated backward-compatibility content fields."
+    ).optional(),
+    state: z.enum(["DRAFT", "PUBLISHED"]).describe("Publication state of the section.").optional(),
+    oldTotalSteps: z.number().int().describe("Legacy total number of steps in the section.").optional(),
+    totalSteps: z.number().int().describe("Total number of steps in the section.").optional().nullable(),
     trialSection: z.boolean().describe(
-      "should we open this section as a trial content even though the owning program isn't purchased yet?"
+      "Whether participants can access the section as trial content before purchasing the parent program."
     ).optional(),
-    ordering: z.number().describe("field for manual ordering of sections").optional(),
-    delayInDays: z.number().int().describe("open after defined number of days passed.").min(0).max(5e3).optional(),
+    ordering: z.number().describe(
+      "Position rank used to order sections within a program. To reorder sections, call Move Section."
+    ).optional(),
+    delayInDays: z.number().int().describe(
+      "Number of days after the parent program starts before the section becomes available. Use `0` to make the section available immediately."
+    ).min(0).max(5e3).optional(),
     extendedFields: z.object({
       namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
         "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
       ).optional()
-    }).describe("extensible field").optional()
-  }).describe("updated section which was moved").optional()
+    }).describe("Custom field data for the section.").optional()
+  }).describe("Moved section.").optional()
 });
 var PublishSectionRequest = z.object({
   options: z.object({
-    sectionId: z.string().describe("Section to publish").regex(
+    sectionId: z.string().describe("ID of the section to publish.").regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
     ).optional(),
-    revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe("section revision").optional(),
+    revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe("Current revision of the section.").optional(),
     fields: z.array(z.enum(["TOTAL_STEPS"])).max(1).optional()
   }).optional()
 });
 var PublishSectionResponse = z.object({
   section: z.object({
-    _id: z.string().describe("Program Section ID.").regex(
+    _id: z.string().describe("Section ID.").regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
     ).optional().nullable(),
     revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-      "Represents the current state of an item. Each time the item is modified, its `revision` changes by the server. for an update operation to succeed, you MUST pass the latest revision"
+      "Revision number, which increments by 1 each time the section is updated. To prevent conflicting changes, the current `revision` must be passed when updating or publishing the section."
     ).optional().nullable(),
-    _createdDate: z.date().describe("Represents the time this Section was created").optional().nullable(),
-    _updatedDate: z.date().describe("Represents the time this Section was last updated").optional().nullable(),
-    programId: z.string().describe("Program Id to which this section is assigned to.").regex(
+    _createdDate: z.date().describe("Date and time the section was created.").optional().nullable(),
+    _updatedDate: z.date().describe("Date and time the section was last updated.").optional().nullable(),
+    programId: z.string().describe(
+      "Program ID of the parent program. Provide it when creating a section. After creation, this value can't be changed."
+    ).regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
     ).optional(),
@@ -775,25 +749,29 @@ var PublishSectionResponse = z.object({
         z.object({ video: z.never().optional(), image: z.string() }),
         z.object({ image: z.never().optional(), video: z.string() })
       ])
-    ).describe("title, description and media content.").optional(),
-    state: z.enum(["DRAFT", "PUBLISHED"]).describe("is this section published yet?").optional(),
-    oldTotalSteps: z.number().int().describe("number of program steps in this section.").optional(),
-    totalSteps: z.number().int().describe("number of program steps in this section.").optional().nullable(),
+    ).describe(
+      "Section title and deprecated backward-compatibility content fields."
+    ).optional(),
+    state: z.enum(["DRAFT", "PUBLISHED"]).describe("Publication state of the section.").optional(),
+    oldTotalSteps: z.number().int().describe("Legacy total number of steps in the section.").optional(),
+    totalSteps: z.number().int().describe("Total number of steps in the section.").optional().nullable(),
     trialSection: z.boolean().describe(
-      "should we open this section as a trial content even though the owning program isn't purchased yet?"
+      "Whether participants can access the section as trial content before purchasing the parent program."
+    ).optional(),
+    ordering: z.number().describe(
+      "Position rank used to order sections within a program. To reorder sections, call Move Section."
     ).optional(),
-    ordering: z.number().describe("field for manual ordering of sections").optional(),
-    delayInDays: z.number().int().describe("open after defined number of days passed.").min(0).max(5e3).optional(),
+    delayInDays: z.number().int().describe(
+      "Number of days after the parent program starts before the section becomes available. Use `0` to make the section available immediately."
+    ).min(0).max(5e3).optional(),
     extendedFields: z.object({
       namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
         "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
       ).optional()
-    }).describe("extensible field").optional()
-  }).describe("Published section").optional()
+    }).describe("Custom field data for the section.").optional()
+  }).describe("Published section.").optional()
 });
 export {
-  BulkCreateSectionMigrationRequest,
-  BulkCreateSectionMigrationResponse,
   BulkCreateSectionRequest,
   BulkCreateSectionResponse,
   CloneSectionRequest,