@wix/auto_sdk_online-programs_sections 1.0.30 → 1.0.31

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

@@ -224,8 +224,10 @@ interface CreateSectionRequest {
     /** Section to create. Must include `section.program_id`. */
     section: Section;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -247,8 +249,10 @@ interface BulkCreateSectionsRequest {
      */
     sections: Section[];
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -311,8 +315,10 @@ interface BulkCreateSectionRequest {
      */
     sections?: Section[];
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -342,11 +348,17 @@ interface GetSectionRequest {
      * @format GUID
      */
     sectionId: string;
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -373,8 +385,10 @@ interface UpdateSectionRequest {
      */
     fieldMask?: string[];
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -409,11 +423,17 @@ interface DeleteAllProgramSectionsResponse {
 interface QuerySectionsRequest {
     /** WQL expression. */
     query?: CursorQuery;
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -546,11 +566,17 @@ interface ListSectionsRequest {
      * @format GUID
      */
     programId: string;
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -568,8 +594,10 @@ interface CloneSectionRequest {
      */
     sectionId: string;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -591,8 +619,10 @@ interface MoveSectionRequest {
     /** Current revision of the section. When provided, it must match the current revision to protect against conflicting updates. */
     revision?: string;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -633,8 +663,10 @@ interface RestoreSectionFromTrashRequest {
      */
     sectionId?: string;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -841,8 +873,10 @@ interface AccountInfo {
 declare function createSection(section: NonNullablePaths<Section, `programId`, 0>, options?: CreateSectionOptions): Promise<NonNullablePaths<Section, `programId` | `description.title` | `ordering` | `delayInDays`, 1>>;
 interface CreateSectionOptions {
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -866,15 +900,15 @@ interface CreateSectionOptions {
 declare function bulkCreateSections(sections: NonNullablePaths<Section, `programId`, 0>[], 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}.action` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 4>>;
 interface BulkCreateSectionsOptions {
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
 /**
  * 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
@@ -886,11 +920,17 @@ interface BulkCreateSectionsOptions {
  */
 declare function getSection(sectionId: string, options?: GetSectionOptions): Promise<NonNullablePaths<Section, `programId` | `description.title` | `ordering` | `delayInDays`, 1>>;
 interface GetSectionOptions {
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -965,8 +1005,10 @@ interface UpdateSectionOptions {
         extendedFields?: ExtendedFields;
     };
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -986,6 +1028,9 @@ declare function deleteSection(sectionId: string): Promise<void>;
 /**
  * Retrieves a list of up to 1,000 sections, given the provided paging, filtering, and sorting.
  *
+ * Use this method when you need to filter sections, apply custom sorting or paging, or query across programs.
+ * When you know the program ID and need all sections in program order, call [List Sections](https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/list-sections).
+ *
  * Query Sections runs with these defaults, which you can override:
  *
  * - `createdDate` is sorted in `DESC` order.
@@ -995,7 +1040,6 @@ declare function deleteSection(sectionId: string): Promise<void>;
  * Supported filter fields are `programId`, `id`, and `delayInDays`.
  * Supported sorting fields are `id`, `delayInDays`, `createdDate`, and `ordering`. When sorting by a field other than `programId`, also filter by `programId`.
  * Section extended fields aren't supported for filtering or sorting. Queries that reference them are rejected.
- * `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
@@ -1006,11 +1050,17 @@ declare function deleteSection(sectionId: string): Promise<void>;
  */
 declare function querySections(options?: QuerySectionsOptions): SectionsQueryBuilder;
 interface QuerySectionsOptions {
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals | undefined;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[] | undefined;
 }
@@ -1181,11 +1231,13 @@ declare const utils: {
     query: _wix_sdk_types.QueryHelpers<Section, SectionQuerySpec, SectionQuery>;
 };
 /**
- * Retrieves the sections in a program.
+ * Retrieves all sections in a program.
+ *
+ * Use this method when you know the program ID and need all sections in program order.
  *
- * Results are sorted by `ordering` in ascending order. `descriptionFieldSet` is retained for backward compatibility. Current section responses return the section title.
+ * Results are sorted by `ordering` in ascending order.
  *
- * To filter or sort sections, call [Query Sections](https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/query-sections).
+ * To filter sections, apply custom sorting or paging, or query across programs, 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
@@ -1196,11 +1248,17 @@ declare const utils: {
  */
 declare function listSections(programId: string, options?: ListSectionsOptions): Promise<NonNullablePaths<ListSectionsResponse, `sections` | `sections.${number}.programId` | `sections.${number}.description.title` | `sections.${number}.ordering` | `sections.${number}.delayInDays`, 3>>;
 interface ListSectionsOptions {
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -1223,8 +1281,10 @@ interface ListSectionsOptions {
 declare function cloneSection(sectionId: string, options?: CloneSectionOptions): Promise<NonNullablePaths<CloneSectionResponse, `section.programId` | `section.description.title` | `section.ordering` | `section.delayInDays`, 2>>;
 interface CloneSectionOptions {
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -1252,8 +1312,10 @@ interface MoveSectionOptions {
     /** Current revision of the section. When provided, it must match the current revision to protect against conflicting updates. */
     revision?: string;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }

package/build/internal/cjs/meta.d.ts

@@ -224,8 +224,10 @@ interface CreateSectionRequest {
     /** Section to create. Must include `section.program_id`. */
     section: Section;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -247,8 +249,10 @@ interface BulkCreateSectionsRequest {
      */
     sections: Section[];
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -311,8 +315,10 @@ interface BulkCreateSectionRequest {
      */
     sections?: Section[];
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -342,11 +348,17 @@ interface GetSectionRequest {
      * @format GUID
      */
     sectionId: string;
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -373,8 +385,10 @@ interface UpdateSectionRequest {
      */
     fieldMask?: string[];
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -409,11 +423,17 @@ interface DeleteAllProgramSectionsResponse {
 interface QuerySectionsRequest {
     /** WQL expression. */
     query?: CursorQuery;
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -546,11 +566,17 @@ interface ListSectionsRequest {
      * @format GUID
      */
     programId: string;
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -568,8 +594,10 @@ interface CloneSectionRequest {
      */
     sectionId: string;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -591,8 +619,10 @@ interface MoveSectionRequest {
     /** Current revision of the section. When provided, it must match the current revision to protect against conflicting updates. */
     revision?: string;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -633,8 +663,10 @@ interface RestoreSectionFromTrashRequest {
      */
     sectionId?: string;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }

package/build/internal/es/index.d.mts

@@ -35,8 +35,6 @@ declare function getSection$1(httpClient: HttpClient): GetSectionSignature;
 interface GetSectionSignature {
     /**
      * Retrieves a section.
-     *
-     * `descriptionFieldSet` is retained for backward compatibility. Current section responses return the section title.
      * @param - ID of the Section to retrieve.
      * @returns Retrieved section.
      */
@@ -68,11 +66,13 @@ interface DeleteSectionSignature {
 declare function listSections$1(httpClient: HttpClient): ListSectionsSignature;
 interface ListSectionsSignature {
     /**
-     * Retrieves the sections in a program.
+     * Retrieves all sections in a program.
+     *
+     * Use this method when you know the program ID and need all sections in program order.
      *
-     * Results are sorted by `ordering` in ascending order. `descriptionFieldSet` is retained for backward compatibility. Current section responses return the section title.
+     * Results are sorted by `ordering` in ascending order.
      *
-     * To filter or sort sections, call [Query Sections](https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/query-sections).
+     * To filter sections, apply custom sorting or paging, or query across programs, call [Query Sections](https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/query-sections).
      * @param - Program ID to list sections for.
      */
     (programId: string, options?: ListSectionsOptions): Promise<NonNullablePaths<ListSectionsResponse, `sections` | `sections.${number}.programId` | `sections.${number}.description.title` | `sections.${number}.ordering` | `sections.${number}.delayInDays`, 3>>;