> Portal Navigation: > > - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version. > - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages). > - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`). > - Top-level index of all portals: https://dev.wix.com/docs/llms.txt > - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt # MoveSection # Package: onlinePrograms # Namespace: SectionsService # Method link: https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/move-section.md ## Permission Scopes: Manage Online Programs: SCOPE.CHALLENGES.MANAGE ## Introduction Moves a section within its program. Each time the section is updated, its `revision` increments by 1. When provided, `revision` must match the current section revision to protect against conflicting updates. If `afterSectionId` isn't specified, the section is moved to the beginning of the program. The stored ordering value is recalculated automatically. --- ## REST API ### Schema ``` Method: moveSection Description: Moves a section within its program. Each time the section is updated, its `revision` increments by 1. When provided, `revision` must match the current section revision to protect against conflicting updates. If `afterSectionId` isn't specified, the section is moved to the beginning of the program. The stored ordering value is recalculated automatically. URL: https://www.wixapis.com/online-programs/v3/sections/move Method: PATCH # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: sectionId Method parameters: param name: afterSectionId | type: afterSectionId | description: GUID of the section that the moved section should be placed after. Leave empty to move the section to the beginning of the program. | validation: format GUID param name: revision | type: revision | description: Current revision of the section. When provided, it must match the current revision to protect against conflicting updates. param name: sectionId | type: sectionId | description: GUID of the section to move. | required: true | validation: format GUID Return type: MoveSectionResponse - name: section | type: Section | description: Moved section. - name: id | type: string | description: Section GUID. | read-only: true | validation: format GUID - name: revision | type: string | description: Revision number, which increments by 1 each time the section is updated. To prevent conflicting changes, the current `revision` must be passed when updating the section. | read-only: true | validation: format int64 - name: createdDate | type: string | description: Date and time the section was created. | read-only: true | validation: format date-time - name: updatedDate | type: string | description: Date and time the section was last updated. | read-only: true | validation: format date-time - name: programId | type: string | description: Program GUID of the parent program. Provide it when creating a section. After creation, this value can't be changed. | read-only: true | validation: format GUID, immutable - name: description | type: Description | description: Section title. - name: title | type: string | description: | validation: maxLength 500 - name: totalSteps | type: integer | description: Total number of steps in the section. | read-only: true | validation: format int32 - name: ordering | type: number | description: Position rank used to order sections within a program. To reorder sections, call Move Section. | read-only: true - name: delayInDays | type: integer | description: Number of days before the section becomes available. The count starts from the program's start date for scheduled programs, or from the participant's enrollment date for self-paced ones. Someone joining a scheduled program after it began may find several sections already open. Use `0` for a section available from the start. | validation: minimum 0, maximum 5000 - name: extendedFields | type: ExtendedFields | description: Custom field data for the section. [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md) must be configured in the app dashboard before they can be accessed with API calls. - name: namespaces | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured. You can only access fields for which you have the appropriate permissions. Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md). | validation: format map ``` ### Examples ### Move a section Moves a section to the beginning of the program by leaving `afterSectionId` empty. ```curl curl -X PATCH \ 'https://www.wixapis.com/online-programs/v3/sections/move' \ -H 'Authorization: ' \ -H 'Content-Type: application/json' \ -d '{ "sectionId": "3b2734ad-62c9-4def-987f-5539533f7abc", "revision": "2" }' ``` --- ## JavaScript SDK ### Schema ``` Method: wixClientAdmin.onlinePrograms.sections.moveSection(sectionId, options) Description: Moves a section within its program. Each time the section is updated, its `revision` increments by 1. When provided, `revision` must match the current section revision to protect against conflicting updates. If `afterSectionId` isn't specified, the section is moved to the beginning of the program. The stored ordering value is recalculated automatically. # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: sectionId Method parameters: param name: options | type: MoveSectionOptions none - name: afterSectionId | type: string | description: GUID of the section that the moved section should be placed after. Leave empty to move the section to the beginning of the program. | validation: format GUID - name: revision | type: string | description: Current revision of the section. When provided, it must match the current revision to protect against conflicting updates. param name: sectionId | type: string | description: GUID of the section to move. | required: true | validation: format GUID Return type: PROMISE - name: section | type: Section | description: Moved section. - name: _id | type: string | description: Section GUID. | read-only: true | validation: format GUID - name: revision | type: string | description: Revision number, which increments by 1 each time the section is updated. To prevent conflicting changes, the current `revision` must be passed when updating the section. | read-only: true | validation: format int64 - name: _createdDate | type: Date | description: Date and time the section was created. | read-only: true - name: _updatedDate | type: Date | description: Date and time the section was last updated. | read-only: true - name: programId | type: string | description: Program GUID of the parent program. Provide it when creating a section. After creation, this value can't be changed. | read-only: true | validation: format GUID, immutable - name: description | type: Description | description: Section title. - name: title | type: string | description: | validation: maxLength 500 - name: totalSteps | type: integer | description: Total number of steps in the section. | read-only: true | validation: format int32 - name: ordering | type: number | description: Position rank used to order sections within a program. To reorder sections, call Move Section. | read-only: true - name: delayInDays | type: integer | description: Number of days before the section becomes available. The count starts from the program's start date for scheduled programs, or from the participant's enrollment date for self-paced ones. Someone joining a scheduled program after it began may find several sections already open. Use `0` for a section available from the start. | validation: minimum 0, maximum 5000 - name: extendedFields | type: ExtendedFields | description: Custom field data for the section. [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md) must be configured in the app dashboard before they can be accessed with API calls. - name: namespaces | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured. You can only access fields for which you have the appropriate permissions. Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md). | validation: format map ``` ### Examples ### Move a section to the beginning of a program ```javascript import { sections } from "@wix/online-programs"; async function moveSection() { const response = await sections.moveSection( "3b2734ad-62c9-4def-987f-5539533f7abc", { revision: "2" }, ); return response; } /* Promise resolves to: * { * "section": { * "_id": "3b2734ad-62c9-4def-987f-5539533f7abc", * "revision": "3", * "ordering": 5 * } * } */ ``` ### moveSection (self-hosted) Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md). ```javascript import { createClient } from '@wix/sdk'; import { sections } from '@wix/online-programs'; // Import the auth strategy for the relevant access type // Import the relevant host module if needed const myWixClient = createClient ({ modules: { sections }, // Include the auth strategy and host as relevant }); async function moveSection(sectionId,options) { const response = await myWixClient.sections.moveSection(sectionId,options); }; ``` ---