@wix/auto_sdk_online-programs_sections 1.0.13 → 1.0.15

package/build/cjs/index.typings.d.ts

@@ -1,58 +1,64 @@
 import * as _wix_sdk_types from '@wix/sdk-types';
 import { QuerySpec, Query, NonNullablePaths } from '@wix/sdk-types';
 
+/**
+ * A section groups related steps within an online program.
+ *
+ * Sections can be drafted, published, reordered, and optionally released after a delay from the start of the parent program.
+ */
 interface Section {
     /**
-     * Program Section ID.
+     * Section ID.
      * @format GUID
      * @readonly
      */
     _id?: string | null;
     /**
-     * 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.
      * @readonly
      */
     revision?: string | null;
     /**
-     * Represents the time this Section was created
+     * Date and time the section was created.
      * @readonly
      */
     _createdDate?: Date | null;
     /**
-     * Represents the time this Section was last updated
+     * Date and time the section was last updated.
      * @readonly
      */
     _updatedDate?: Date | null;
     /**
-     * Program Id to which this section is assigned to.
+     * Program ID of the parent program. Provide it when creating a section. After creation, this value can't be changed.
      * @format GUID
      * @readonly
+     * @immutable
      */
     programId?: string;
-    /** title, description and media content. */
+    /** Section title and deprecated backward-compatibility content fields. */
     description?: Description;
-    /** is this section published yet? */
+    /** Publication state of the section. */
     state?: StateWithLiterals;
     /**
-     * number of program steps in this section.
+     * Legacy total number of steps in the section.
      * @readonly
      */
     oldTotalSteps?: number;
     /**
-     * number of program steps in this section.
+     * Total number of steps in the section.
      * @readonly
      */
     totalSteps?: number | null;
-    /** 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. */
     trialSection?: boolean;
-    /** field for manual ordering of sections */
+    /** Position rank used to order sections within a program. To reorder sections, call Move Section. */
     ordering?: number;
     /**
-     * open after defined number of days passed.
+     * Number of days after the parent program starts before the section becomes available. Use `0` to make the section available immediately.
      * @max 5000
      */
     delayInDays?: number;
-    /** extensible field */
+    /** Custom field data for the section. */
     extendedFields?: ExtendedFields;
 }
 interface Description extends DescriptionMediaOneOf {
@@ -68,7 +74,11 @@ interface Description extends DescriptionMediaOneOf {
     video?: string;
     /** @maxLength 500 */
     title?: string;
-    /** @maxLength 10000000 */
+    /**
+     * @maxLength 10000000
+     * @deprecated
+     * @targetRemovalDate 2026-06-25
+     */
     details?: string | null;
 }
 /** @oneof */
@@ -234,40 +244,43 @@ interface UpdateExistingOperation {
     /** documents to update */
     documents?: IndexDocument[];
 }
+/** Payload for the Section Updated event. */
 interface SectionUpdated {
-    /** Section before update. */
+    /** Section before the update. */
     previous?: Section;
-    /** Section after update. */
+    /** Section after the update. */
     current?: Section;
 }
+/** Payload for the Section Deleted event. */
 interface SectionDeleted {
-    /** Full section that was deleted */
+    /** Section that was deleted. */
     section?: Section;
 }
+/** Payload for the Section Cloned event. */
 interface SectionCloned {
-    /** Section which was used as a prototype for cloning. */
+    /** Source section used for cloning. */
     prototype?: Section;
-    /** Result of section cloning. */
+    /** Cloned section. */
     cloned?: Section;
 }
 interface SectionMoved {
     /**
-     * Moved section id
+     * ID of the moved section.
      * @format GUID
      */
     sectionId?: string;
-    /** section position */
+    /** New ordering rank assigned to the moved section. */
     newSectionPositionRank?: number;
 }
 interface SectionPublished {
     /**
-     * Published section id
+     * ID of the published section.
      * @format GUID
      */
     sectionId?: string;
 }
 interface CreateSectionRequest {
-    /** Section to be created. */
+    /** Section to create. Must include `section.program_id`. */
     section: Section;
     /**
      * Predefined sets of fields to return.
@@ -282,12 +295,12 @@ declare enum RequestedFields {
 /** @enumType */
 type RequestedFieldsWithLiterals = RequestedFields | 'TOTAL_STEPS';
 interface CreateSectionResponse {
-    /** The created Section. */
+    /** Created section. */
     section?: Section;
 }
-interface BulkCreateSectionRequest {
+interface BulkCreateSectionsRequest {
     /**
-     * List of sections you want to create
+     * List of sections to create. Each section must include `program_id`, and all sections must belong to the same program.
      * @minSize 1
      * @maxSize 100
      */
@@ -298,18 +311,18 @@ interface BulkCreateSectionRequest {
      */
     fields?: RequestedFieldsWithLiterals[];
 }
-interface BulkCreateSectionResponse {
-    /** bulk results */
+interface BulkCreateSectionsResponse {
+    /** Results for the bulk create operation. */
     results?: BulkSectionResult[];
-    /** bulk metadata */
+    /** Summary of the bulk create operation. */
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface BulkSectionResult {
-    /** item metadata */
+    /** Metadata for the bulk operation result. */
     itemMetadata?: ItemMetadata;
-    /** created section */
+    /** Created section. */
     item?: Section;
-    /** indicator whether it was create or update */
+    /** Action associated with the bulk result. */
     action?: BulkActionTypeWithLiterals;
 }
 interface ItemMetadata {
@@ -346,18 +359,37 @@ interface BulkActionMetadata {
     /** Number of failures without details because detailed failure threshold was exceeded. */
     undetailedFailures?: number;
 }
-interface BulkCreateSectionMigrationRequest {
+interface BulkCreateSectionRequest {
     /**
-     * List of sections you want to create
+     * List of sections to create. Each section must include `program_id`, and all sections must belong to the same program.
      * @minSize 1
      * @maxSize 100
      */
     sections: Section[];
+    /**
+     * Predefined sets of fields to return.
+     * @maxSize 1
+     */
+    fields?: RequestedFieldsWithLiterals[];
+}
+interface BulkCreateSectionResponse {
+    /** Results for the bulk create operation. */
+    results?: BulkSectionResult[];
+    /** Summary of the bulk create operation. */
+    bulkActionMetadata?: BulkActionMetadata;
+}
+interface BulkCreateSectionMigrationRequest {
+    /**
+     * List of sections to create.
+     * @minSize 1
+     * @maxSize 100
+     */
+    sections?: Section[];
 }
 interface BulkCreateSectionMigrationResponse {
-    /** bulk results */
+    /** Results for the bulk create operation. */
     results?: BulkSectionResult[];
-    /** bulk metadata */
+    /** Summary of the bulk create operation. */
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface GetSectionRequest {
@@ -366,7 +398,7 @@ interface GetSectionRequest {
      * @format GUID
      */
     sectionId: string;
-    /** Whenever to return description only with title or with details as well */
+    /** Compatibility option for existing integrations. Current section responses return the section title. */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
      * Predefined sets of fields to return.
@@ -375,17 +407,19 @@ interface GetSectionRequest {
     fields?: RequestedFieldsWithLiterals[];
 }
 declare enum DescriptionFieldSet {
+    /** Retained for backward compatibility. Current section responses return the section title. */
     STANDARD = "STANDARD",
+    /** Retained for backward compatibility. Current section responses return the section title. */
     EXTENDED = "EXTENDED"
 }
 /** @enumType */
 type DescriptionFieldSetWithLiterals = DescriptionFieldSet | 'STANDARD' | 'EXTENDED';
 interface GetSectionResponse {
-    /** The requested Section. */
+    /** Retrieved section. */
     section?: Section;
 }
 interface UpdateSectionRequest {
-    /** Section to be updated, may be partial. */
+    /** Section to update. Include `section.id`, `section.revision`, and the fields to update. */
     section?: Section;
     /**
      * Predefined sets of fields to return.
@@ -394,12 +428,12 @@ interface UpdateSectionRequest {
     fields?: RequestedFieldsWithLiterals[];
 }
 interface UpdateSectionResponse {
-    /** Updated Section. */
+    /** Updated section. */
     section?: Section;
 }
 interface DeleteSectionRequest {
     /**
-     * Id of the Section to delete.
+     * ID of the section to delete.
      * @format GUID
      */
     sectionId: string;
@@ -408,26 +442,26 @@ interface DeleteSectionResponse {
 }
 interface DeleteAllProgramSectionsRequest {
     /**
-     * Program id to delete sections from
+     * Program ID to delete sections from.
      * @format GUID
      */
     programId?: string;
 }
 interface DeleteAllProgramSectionsResponse {
-    /** Total count of sections in the program */
+    /** Total number of sections in the program. */
     sectionsTotal?: number;
-    /** Count of successfully deleted sections */
+    /** Number of sections that were deleted successfully. */
     successfulCount?: number;
-    /** Count of sections that failed to be deleted */
+    /** Number of sections that couldn't be deleted. */
     failedCount?: number;
 }
 interface QuerySectionsRequest {
     /** WQL expression. */
     query?: CursorQuery;
-    /** Whenever to return description only with title or with details as well */
+    /** Compatibility option for existing integrations. Current section responses return the section title. */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * 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.
      * @deprecated
      * @replacedBy wix.common.CursorQuery
      * @targetRemovalDate 2026-06-30
@@ -477,6 +511,11 @@ interface Sorting {
     fieldName?: string;
     /** Sort order. */
     order?: SortOrderWithLiterals;
+    /**
+     * Origin point for geo-distance sorting on a GEO field
+     * results are ordered by distance from this point (ASC = nearest first, DESC = farthest first).
+     */
+    origin?: AddressLocation;
 }
 declare enum SortOrder {
     ASC = "ASC",
@@ -484,6 +523,12 @@ declare enum SortOrder {
 }
 /** @enumType */
 type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC';
+interface AddressLocation {
+    /** Address latitude. */
+    latitude?: number | null;
+    /** Address longitude. */
+    longitude?: number | null;
+}
 interface CursorPaging {
     /**
      * Maximum number of items to return in the results.
@@ -500,9 +545,9 @@ interface CursorPaging {
     cursor?: string | null;
 }
 interface QuerySectionsResponse {
-    /** List of Sections. */
+    /** Matching sections. */
     sections?: Section[];
-    /** Paging metadata */
+    /** Paging metadata. */
     pagingMetadata?: CursorPagingMetadata;
 }
 interface CursorPagingMetadata {
@@ -532,11 +577,11 @@ interface Cursors {
 }
 interface ListSectionsRequest {
     /**
-     * Program id to list sections
+     * Program ID to list sections for.
      * @format GUID
      */
     programId: string;
-    /** Whenever to return description only with title or with details as well */
+    /** Compatibility option for existing integrations. Current section responses return the section title. */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
      * Predefined sets of fields to return.
@@ -546,14 +591,14 @@ interface ListSectionsRequest {
 }
 interface ListSectionsResponse {
     /**
-     * sections
+     * Sections in the requested program.
      * @maxSize 1000
      */
     sections?: Section[];
 }
 interface CloneSectionRequest {
     /**
-     * Section to clone
+     * ID of the section to clone.
      * @format GUID
      */
     sectionId: string;
@@ -564,21 +609,21 @@ interface CloneSectionRequest {
     fields?: RequestedFieldsWithLiterals[];
 }
 interface CloneSectionResponse {
-    /** cloned section */
+    /** Cloned section. */
     section?: Section;
 }
 interface MoveSectionRequest {
     /**
-     * Section to move
+     * ID of the section to move.
      * @format GUID
      */
     sectionId?: string;
     /**
-     * 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.
      * @format GUID
      */
     afterSectionId?: string | null;
-    /** section revision */
+    /** Current revision of the section. */
     revision?: string;
     /**
      * Predefined sets of fields to return.
@@ -587,16 +632,16 @@ interface MoveSectionRequest {
     fields?: RequestedFieldsWithLiterals[];
 }
 interface MoveSectionResponse {
-    /** updated section which was moved */
+    /** Moved section. */
     section?: Section;
 }
 interface PublishSectionRequest {
     /**
-     * Section to publish
+     * ID of the section to publish.
      * @format GUID
      */
     sectionId?: string;
-    /** section revision */
+    /** Current revision of the section. */
     revision?: string;
     /**
      * Predefined sets of fields to return.
@@ -605,38 +650,38 @@ interface PublishSectionRequest {
     fields?: RequestedFieldsWithLiterals[];
 }
 interface PublishSectionResponse {
-    /** Published section */
+    /** Published section. */
     section?: Section;
 }
 interface BulkCloneSectionRequest {
     /**
-     * id of program which was cloned
+     * ID of the program that was cloned.
      * @format GUID
      */
     prototypeProgramId?: string;
     /**
-     * id of program created after clone
+     * ID of the program created by the clone operation.
      * @format GUID
      */
     clonedProgramId?: string;
 }
 interface BulkCloneSectionResponse {
     /**
-     * id of program which was cloned
+     * ID of the program that was cloned.
      * @format GUID
      */
     prototypeProgramId?: string;
     /**
-     * id of program created after clone
+     * ID of the program created by the clone operation.
      * @format GUID
      */
     clonedProgramId?: string;
-    /** mapping of original to cloned section ids */
+    /** Mapping from original section IDs to cloned section IDs. */
     prototypeIdToClonedId?: Record<string, string>;
 }
 interface RestoreSectionFromTrashRequest {
     /**
-     * section id to restore
+     * ID of the section to restore.
      * @format GUID
      */
     sectionId?: string;
@@ -647,7 +692,7 @@ interface RestoreSectionFromTrashRequest {
     fields?: RequestedFieldsWithLiterals[];
 }
 interface RestoreSectionFromTrashResponse {
-    /** restored section */
+    /** Restored section. */
     section?: Section;
 }
 interface DomainEvent extends DomainEventBodyOneOf {
@@ -679,7 +724,7 @@ interface DomainEvent extends DomainEventBodyOneOf {
     /** If present, indicates the action that triggered the event. */
     originatedFrom?: string | null;
     /**
-     * A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number.
+     * A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at `16:00` and then again at `16:01`, the second update will always have a higher sequence number.
      * You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
      */
     entityEventSequence?: string | null;
@@ -829,14 +874,18 @@ interface AccountInfo {
     siteId?: string | null;
 }
 /**
- * Creates a Section.
- * @param section - Section to be created.
+ * Creates a section.
+ *
+ * The section is added to the program identified by `section.program_id`. Provide that program ID in the request. Set `section.description.title` for the section title. `section.description.details`, `section.description.image`, and `section.description.video` are deprecated backward-compatibility fields. The stored ordering value is assigned automatically.
+ *
+ * To create multiple sections in a single API call, call [Bulk Create Sections](https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/bulk-create-sections).
+ * @param section - Section to create. Must include `section.program_id`.
  * @public
  * @documentationMaturity preview
  * @requiredField section
  * @permissionId ONLINE_PROGRAMS.SECTION_CREATE
  * @applicableIdentity APP
- * @returns The created Section.
+ * @returns Created section.
  * @fqn wix.onlineprograms.sections.v3.SectionsService.CreateSection
  */
 declare function createSection(section: Section, options?: CreateSectionOptions): Promise<NonNullablePaths<Section, `programId` | `description.title` | `state` | `oldTotalSteps` | `trialSection` | `ordering` | `delayInDays`, 3>>;
@@ -848,17 +897,21 @@ interface CreateSectionOptions {
     fields?: RequestedFieldsWithLiterals[];
 }
 /**
- * Bulk Section creation.
- * @param sections - List of sections you want to create
+ * Creates up to 100 sections in a single API call.
+ *
+ * All sections in the request must include `program_id` and belong to the same program. Set `description.title` for each section title. `description.details`, `description.image`, and `description.video` are deprecated backward-compatibility fields. The stored ordering values are assigned automatically.
+ *
+ * To create a single section, call [Create Section](https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/create-section).
+ * @param sections - List of sections to create. Each section must include `program_id`, and all sections must belong to the same program.
  * @public
  * @documentationMaturity preview
  * @requiredField sections
  * @permissionId ONLINE_PROGRAMS.SECTION_CREATE
  * @applicableIdentity APP
- * @fqn wix.onlineprograms.sections.v3.SectionsService.BulkCreateSection
+ * @fqn wix.onlineprograms.sections.v3.SectionsService.BulkCreateSections
  */
-declare function bulkCreateSection(sections: Section[], options?: BulkCreateSectionOptions): Promise<NonNullablePaths<BulkCreateSectionResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.programId` | `results.${number}.item.description.title` | `results.${number}.item.state` | `results.${number}.item.oldTotalSteps` | `results.${number}.item.trialSection` | `results.${number}.item.ordering` | `results.${number}.item.delayInDays` | `results.${number}.action` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
-interface BulkCreateSectionOptions {
+declare function bulkCreateSections(sections: Section[], options?: BulkCreateSectionsOptions): Promise<NonNullablePaths<BulkCreateSectionsResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.programId` | `results.${number}.item.description.title` | `results.${number}.item.state` | `results.${number}.item.oldTotalSteps` | `results.${number}.item.trialSection` | `results.${number}.item.ordering` | `results.${number}.item.delayInDays` | `results.${number}.action` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
+interface BulkCreateSectionsOptions {
     /**
      * Predefined sets of fields to return.
      * @maxSize 1
@@ -866,30 +919,44 @@ interface BulkCreateSectionOptions {
     fields?: RequestedFieldsWithLiterals[];
 }
 /**
- * Bulk Section creation for migration.
- * @param sections - List of sections you want to create
+ * Deprecated. Use [Bulk Create Sections](https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/bulk-create-sections).
+ *
+ * To create a single section, call [Create Section](https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/create-section).
+ * @param sections - List of sections to create. Each section must include `program_id`, and all sections must belong to the same program.
  * @public
  * @documentationMaturity preview
  * @requiredField sections
  * @permissionId ONLINE_PROGRAMS.SECTION_CREATE
  * @applicableIdentity APP
- * @fqn wix.onlineprograms.sections.v3.SectionsService.BulkCreateSectionMigration
+ * @fqn wix.onlineprograms.sections.v3.SectionsService.BulkCreateSection
+ * @deprecated
+ * @replacedBy wix.onlineprograms.sections.v3.SectionsService.BulkCreateSections
+ * @targetRemovalDate 2026-07-24
  */
-declare function bulkCreateSectionMigration(sections: Section[]): Promise<NonNullablePaths<BulkCreateSectionMigrationResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.programId` | `results.${number}.item.description.title` | `results.${number}.item.state` | `results.${number}.item.oldTotalSteps` | `results.${number}.item.trialSection` | `results.${number}.item.ordering` | `results.${number}.item.delayInDays` | `results.${number}.action` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
+declare function bulkCreateSection(sections: Section[], options?: BulkCreateSectionOptions): Promise<NonNullablePaths<BulkCreateSectionResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.programId` | `results.${number}.item.description.title` | `results.${number}.item.state` | `results.${number}.item.oldTotalSteps` | `results.${number}.item.trialSection` | `results.${number}.item.ordering` | `results.${number}.item.delayInDays` | `results.${number}.action` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
+interface BulkCreateSectionOptions {
+    /**
+     * Predefined sets of fields to return.
+     * @maxSize 1
+     */
+    fields?: RequestedFieldsWithLiterals[];
+}
 /**
- * Retrieves a Section.
+ * Retrieves a section.
+ *
+ * `descriptionFieldSet` is retained for backward compatibility. Current section responses return the section title.
  * @param sectionId - ID of the Section to retrieve.
  * @public
  * @documentationMaturity preview
  * @requiredField sectionId
  * @permissionId ONLINE_PROGRAMS.SECTION_READ
  * @applicableIdentity APP
- * @returns The requested Section.
+ * @returns Retrieved section.
  * @fqn wix.onlineprograms.sections.v3.SectionsService.GetSection
  */
 declare function getSection(sectionId: string, options?: GetSectionOptions): Promise<NonNullablePaths<Section, `programId` | `description.title` | `state` | `oldTotalSteps` | `trialSection` | `ordering` | `delayInDays`, 3>>;
 interface GetSectionOptions {
-    /** Whenever to return description only with title or with details as well */
+    /** Compatibility option for existing integrations. Current section responses return the section title. */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
      * Predefined sets of fields to return.
@@ -898,71 +965,76 @@ interface GetSectionOptions {
     fields?: RequestedFieldsWithLiterals[];
 }
 /**
- * Updates a Section.
- * @param _id - Program Section ID.
+ * Updates a section.
+ *
+ * Each time the section is updated, `revision` increments by 1. The current `revision` must be passed when updating the section. This ensures you're working with the latest section and prevents unintended overwrites.
+ *
+ * Use this method to update section content and settings. To reorder a section, call [Move Section](https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/move-section). To publish a section, call [Publish Section](https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/publish-section).
+ * @param _id - Section ID.
  * @public
  * @documentationMaturity preview
  * @requiredField _id
  * @requiredField options.section.revision
  * @permissionId ONLINE_PROGRAMS.SECTION_UPDATE
  * @applicableIdentity APP
- * @returns Updated Section.
+ * @returns Updated section.
  * @fqn wix.onlineprograms.sections.v3.SectionsService.UpdateSection
  */
 declare function updateSection(_id: string, options?: NonNullablePaths<UpdateSectionOptions, `section.revision`, 3>): Promise<NonNullablePaths<Section, `programId` | `description.title` | `state` | `oldTotalSteps` | `trialSection` | `ordering` | `delayInDays`, 3>>;
 interface UpdateSectionOptions {
     section?: {
         /**
-         * Program Section ID.
+         * Section ID.
          * @format GUID
          * @readonly
          */
         _id?: string | null;
         /**
-         * 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.
          * @readonly
          */
         revision?: string | null;
         /**
-         * Represents the time this Section was created
+         * Date and time the section was created.
          * @readonly
          */
         _createdDate?: Date | null;
         /**
-         * Represents the time this Section was last updated
+         * Date and time the section was last updated.
          * @readonly
          */
         _updatedDate?: Date | null;
         /**
-         * Program Id to which this section is assigned to.
+         * Program ID of the parent program. Provide it when creating a section. After creation, this value can't be changed.
          * @format GUID
          * @readonly
+         * @immutable
          */
         programId?: string;
-        /** title, description and media content. */
+        /** Section title and deprecated backward-compatibility content fields. */
         description?: Description;
-        /** is this section published yet? */
+        /** Publication state of the section. */
         state?: StateWithLiterals;
         /**
-         * number of program steps in this section.
+         * Legacy total number of steps in the section.
          * @readonly
          */
         oldTotalSteps?: number;
         /**
-         * number of program steps in this section.
+         * Total number of steps in the section.
          * @readonly
          */
         totalSteps?: number | null;
-        /** 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. */
         trialSection?: boolean;
-        /** field for manual ordering of sections */
+        /** Position rank used to order sections within a program. To reorder sections, call Move Section. */
         ordering?: number;
         /**
-         * open after defined number of days passed.
+         * Number of days after the parent program starts before the section becomes available. Use `0` to make the section available immediately.
          * @max 5000
          */
         delayInDays?: number;
-        /** extensible field */
+        /** Custom field data for the section. */
         extendedFields?: ExtendedFields;
     };
     /**
@@ -972,9 +1044,10 @@ interface UpdateSectionOptions {
     fields?: RequestedFieldsWithLiterals[];
 }
 /**
- * Deletes a Section.
- * Deleting a Section permanently removes them from the Section List.
- * @param sectionId - Id of the Section to delete.
+ * Permanently deletes a section from the public API.
+ *
+ * Deleted sections aren't returned by standard retrieval and list methods. The public API doesn't expose trash-bin or restore operations.
+ * @param sectionId - ID of the section to delete.
  * @public
  * @documentationMaturity preview
  * @requiredField sectionId
@@ -984,9 +1057,19 @@ interface UpdateSectionOptions {
  */
 declare function deleteSection(sectionId: string): Promise<void>;
 /**
- * Retrieves a list of Sections, given the provided [paging, filtering, and sorting][1].
+ * Retrieves a list of up to 1,000 sections, given the provided paging, filtering, and sorting.
  *
- * Up to 1,000 Sections can be returned per request.
+ * Query Sections runs with these defaults, which you can override:
+ *
+ * - `createdDate` is sorted in `DESC` order.
+ * - `paging.limit` is `1000`.
+ * - `paging.offset` is `0`.
+ *
+ * Supported filter fields are `programId`, `id`, `delayInDays`, `trialSection`, and `state`.
+ * Supported sorting fields are `id`, `delayInDays`, `trialSection`, `state`, `createdDate`, and `ordering`. When sorting by a field other than `programId`, also filter by `programId`.
+ * `descriptionFieldSet` is retained for backward compatibility. Current section responses return the section title.
+ *
+ * To learn about working with Query methods, see [API Query Language](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language), [Sorting and Paging](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-sorting-and-paging), and [Field Projection](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-field-projection).
  * @public
  * @documentationMaturity preview
  * @permissionId ONLINE_PROGRAMS.SECTION_READ
@@ -995,10 +1078,10 @@ declare function deleteSection(sectionId: string): Promise<void>;
  */
 declare function querySections(options?: QuerySectionsOptions): SectionsQueryBuilder;
 interface QuerySectionsOptions {
-    /** Whenever to return description only with title or with details as well */
+    /** Compatibility option for existing integrations. Current section responses return the section title. */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals | undefined;
     /**
-     * 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.
      * @deprecated
      * @replacedBy wix.common.CursorQuery
      * @targetRemovalDate 2026-06-30
@@ -1157,6 +1240,11 @@ type SectionQuery = {
       Sort order.
       */
         order?: NonNullable<CommonQueryWithEntityContext['sort']>[number]['order'];
+        /**
+      Origin point for geo-distance sorting on a GEO field
+      results are ordered by distance from this point (ASC = nearest first, DESC = farthest first).
+      */
+        origin?: NonNullable<CommonQueryWithEntityContext['sort']>[number]['origin'];
     }[];
 };
 declare const utils: {
@@ -1167,8 +1255,12 @@ declare const utils: {
     };
 };
 /**
- * List sections per program id
- * @param programId - Program id to list sections
+ * Retrieves the sections in a program.
+ *
+ * Results are sorted by `ordering` in ascending order. `descriptionFieldSet` is retained for backward compatibility. Current section responses return the section title.
+ *
+ * To filter or sort sections, call [Query Sections](https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/query-sections).
+ * @param programId - Program ID to list sections for.
  * @public
  * @documentationMaturity preview
  * @requiredField programId
@@ -1178,7 +1270,7 @@ declare const utils: {
  */
 declare function listSections(programId: string, options?: ListSectionsOptions): Promise<NonNullablePaths<ListSectionsResponse, `sections` | `sections.${number}.programId` | `sections.${number}.description.title` | `sections.${number}.state` | `sections.${number}.oldTotalSteps` | `sections.${number}.trialSection` | `sections.${number}.ordering` | `sections.${number}.delayInDays`, 5>>;
 interface ListSectionsOptions {
-    /** Whenever to return description only with title or with details as well */
+    /** Compatibility option for existing integrations. Current section responses return the section title. */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
      * Predefined sets of fields to return.
@@ -1187,8 +1279,10 @@ interface ListSectionsOptions {
     fields?: RequestedFieldsWithLiterals[];
 }
 /**
- * Clones section with specified id
- * @param sectionId - Section to clone
+ * Clones a section.
+ *
+ * The cloned section is added to the same program after the current last section. Translation content is copied to the cloned section.
+ * @param sectionId - ID of the section to clone.
  * @public
  * @documentationMaturity preview
  * @requiredField sectionId
@@ -1205,7 +1299,9 @@ interface CloneSectionOptions {
     fields?: RequestedFieldsWithLiterals[];
 }
 /**
- * Places section after specified one or inserts it in the beginning
+ * Moves a section within its program.
+ *
+ * If `afterSectionId` isn't specified, the section is moved to the beginning of the program. The stored ordering value is recalculated automatically.
  * @public
  * @documentationMaturity preview
  * @permissionId ONLINE_PROGRAMS.SECTION_UPDATE
@@ -1215,16 +1311,16 @@ interface CloneSectionOptions {
 declare function moveSection(options?: MoveSectionOptions): Promise<NonNullablePaths<MoveSectionResponse, `section.programId` | `section.description.title` | `section.state` | `section.oldTotalSteps` | `section.trialSection` | `section.ordering` | `section.delayInDays`, 4>>;
 interface MoveSectionOptions {
     /**
-     * Section to move
+     * ID of the section to move.
      * @format GUID
      */
     sectionId?: string;
     /**
-     * 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.
      * @format GUID
      */
     afterSectionId?: string | null;
-    /** section revision */
+    /** Current revision of the section. */
     revision?: string;
     /**
      * Predefined sets of fields to return.
@@ -1233,7 +1329,11 @@ interface MoveSectionOptions {
     fields?: RequestedFieldsWithLiterals[];
 }
 /**
- * Publishes section
+ * Publishes a section.
+ *
+ * Each time the section is updated, `revision` increments by 1. The current `revision` must be passed when publishing the section. This ensures you're working with the latest section and prevents unintended overwrites.
+ *
+ * Publishing sets the section's `state` to `PUBLISHED`.
  * @public
  * @documentationMaturity preview
  * @permissionId ONLINE_PROGRAMS.SECTION_UPDATE
@@ -1243,11 +1343,11 @@ interface MoveSectionOptions {
 declare function publishSection(options?: PublishSectionOptions): Promise<NonNullablePaths<PublishSectionResponse, `section.programId` | `section.description.title` | `section.state` | `section.oldTotalSteps` | `section.trialSection` | `section.ordering` | `section.delayInDays`, 4>>;
 interface PublishSectionOptions {
     /**
-     * Section to publish
+     * ID of the section to publish.
      * @format GUID
      */
     sectionId?: string;
-    /** section revision */
+    /** Current revision of the section. */
     revision?: string;
     /**
      * Predefined sets of fields to return.
@@ -1256,4 +1356,4 @@ interface PublishSectionOptions {
     fields?: RequestedFieldsWithLiterals[];
 }
 
-export { type AccountInfo, type ActionEvent, type ApplicationError, type BulkActionMetadata, BulkActionType, type BulkActionTypeWithLiterals, type BulkCloneSectionRequest, type BulkCloneSectionResponse, type BulkCreateSectionMigrationRequest, type BulkCreateSectionMigrationResponse, type BulkCreateSectionOptions, type BulkCreateSectionRequest, type BulkCreateSectionResponse, type BulkSectionResult, type CloneSectionOptions, type CloneSectionRequest, type CloneSectionResponse, type CommonQueryWithEntityContext, type CreateSectionOptions, type CreateSectionRequest, type CreateSectionResponse, type CursorPaging, type CursorPagingMetadata, type CursorQuery, type CursorQueryPagingMethodOneOf, type Cursors, type DeleteAllProgramSectionsRequest, type DeleteAllProgramSectionsResponse, type DeleteByFilterOperation, type DeleteByIdsOperation, type DeleteSectionRequest, type DeleteSectionResponse, type Description, DescriptionFieldSet, type DescriptionFieldSetWithLiterals, type DescriptionMediaOneOf, type DocumentImage, type DocumentPayload, type DocumentUpdateOperation, type DomainEvent, type DomainEventBodyOneOf, type Empty, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, Enum, type EnumWithLiterals, type ExtendedFields, type FocalPoint, type GetSectionOptions, type GetSectionRequest, type GetSectionResponse, type IdentificationData, type IdentificationDataIdOneOf, type IndexDocument, type ItemMetadata, type ListSectionsOptions, type ListSectionsRequest, type ListSectionsResponse, type MessageEnvelope, type MoveSectionOptions, type MoveSectionRequest, type MoveSectionResponse, type PublishSectionOptions, type PublishSectionRequest, type PublishSectionResponse, type QuerySectionsOptions, type QuerySectionsRequest, type QuerySectionsResponse, RequestedFields, type RequestedFieldsWithLiterals, type RestoreInfo, type RestoreSectionFromTrashRequest, type RestoreSectionFromTrashResponse, type SearchIndexingNotification, SearchIndexingNotificationState, type SearchIndexingNotificationStateWithLiterals, type Section, type SectionCloned, type SectionDeleted, type SectionMoved, type SectionPublished, type SectionQuery, type SectionQuerySpec, type SectionUpdated, type SectionsQueryBuilder, type SectionsQueryResult, SortOrder, type SortOrderWithLiterals, type Sorting, State, type StateWithLiterals, type UpdateByFilterOperation, type UpdateDocumentsEvent, type UpdateDocumentsEventOperationOneOf, type UpdateExistingOperation, type UpdateSectionOptions, type UpdateSectionRequest, type UpdateSectionResponse, type VideoResolution, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, bulkCreateSection, bulkCreateSectionMigration, cloneSection, createSection, deleteSection, getSection, listSections, moveSection, publishSection, querySections, typedQuerySections, updateSection, utils };
+export { type AccountInfo, type ActionEvent, type AddressLocation, type ApplicationError, type BulkActionMetadata, BulkActionType, type BulkActionTypeWithLiterals, type BulkCloneSectionRequest, type BulkCloneSectionResponse, type BulkCreateSectionMigrationRequest, type BulkCreateSectionMigrationResponse, type BulkCreateSectionOptions, type BulkCreateSectionRequest, type BulkCreateSectionResponse, type BulkCreateSectionsOptions, type BulkCreateSectionsRequest, type BulkCreateSectionsResponse, type BulkSectionResult, type CloneSectionOptions, type CloneSectionRequest, type CloneSectionResponse, type CommonQueryWithEntityContext, type CreateSectionOptions, type CreateSectionRequest, type CreateSectionResponse, type CursorPaging, type CursorPagingMetadata, type CursorQuery, type CursorQueryPagingMethodOneOf, type Cursors, type DeleteAllProgramSectionsRequest, type DeleteAllProgramSectionsResponse, type DeleteByFilterOperation, type DeleteByIdsOperation, type DeleteSectionRequest, type DeleteSectionResponse, type Description, DescriptionFieldSet, type DescriptionFieldSetWithLiterals, type DescriptionMediaOneOf, type DocumentImage, type DocumentPayload, type DocumentUpdateOperation, type DomainEvent, type DomainEventBodyOneOf, type Empty, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, Enum, type EnumWithLiterals, type ExtendedFields, type FocalPoint, type GetSectionOptions, type GetSectionRequest, type GetSectionResponse, type IdentificationData, type IdentificationDataIdOneOf, type IndexDocument, type ItemMetadata, type ListSectionsOptions, type ListSectionsRequest, type ListSectionsResponse, type MessageEnvelope, type MoveSectionOptions, type MoveSectionRequest, type MoveSectionResponse, type PublishSectionOptions, type PublishSectionRequest, type PublishSectionResponse, type QuerySectionsOptions, type QuerySectionsRequest, type QuerySectionsResponse, RequestedFields, type RequestedFieldsWithLiterals, type RestoreInfo, type RestoreSectionFromTrashRequest, type RestoreSectionFromTrashResponse, type SearchIndexingNotification, SearchIndexingNotificationState, type SearchIndexingNotificationStateWithLiterals, type Section, type SectionCloned, type SectionDeleted, type SectionMoved, type SectionPublished, type SectionQuery, type SectionQuerySpec, type SectionUpdated, type SectionsQueryBuilder, type SectionsQueryResult, SortOrder, type SortOrderWithLiterals, type Sorting, State, type StateWithLiterals, type UpdateByFilterOperation, type UpdateDocumentsEvent, type UpdateDocumentsEventOperationOneOf, type UpdateExistingOperation, type UpdateSectionOptions, type UpdateSectionRequest, type UpdateSectionResponse, type VideoResolution, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, bulkCreateSection, bulkCreateSections, cloneSection, createSection, deleteSection, getSection, listSections, moveSection, publishSection, querySections, typedQuerySections, updateSection, utils };