> ## Documentation Index
> Fetch the complete documentation index at: https://docs.schoolmaker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Move a Section

> Moves a section with its lessons and steps, keeping learner progress. Member access follows the destination program and question category settings.



## OpenAPI

````yaml /api-reference/openapi.json post /sections/{id}/move
openapi: 3.0.1
info:
  title: SchoolMaker API V1
  description: API for managing your SchoolMaker school
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://schoolmaker.co/api/v1
    description: Production API
security:
  - bearerAuth: []
paths:
  /sections/{id}/move:
    post:
      tags:
        - Sections
      summary: Move a Section
      description: >-
        Moves a section with its lessons and steps, keeping learner progress.
        Member access follows the destination program and question category
        settings.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - destination_program_id
              properties:
                destination_program_id:
                  type: string
                  minLength: 1
                  maxLength: 255
                  description: >-
                    Destination program ID. You need edit access to both
                    programs. On a cross-program move, the section goes to the
                    end of the destination program. Omit the group ID to use the
                    destination program's last group.
                destination_section_group_id:
                  type: string
                  minLength: 1
                  maxLength: 255
                  description: >-
                    Destination section group ID. It must belong to the
                    destination program. Supply it to change groups within the
                    same program. If the section is already in the selected
                    location, the API returns it unchanged.
              additionalProperties: false
            example:
              destination_program_id: PROGRAM_ID
              destination_section_group_id: GROUP_ID
      responses:
        '200':
          description: Successful operation.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  product_id:
                    type: string
                  section_group_id:
                    type: string
                    nullable: true
                  section_group_position:
                    type: integer
                    nullable: true
                  name:
                    type: string
                  description:
                    type: string
                  position:
                    type: integer
                    nullable: true
                  drip_delay:
                    type: integer
                  is_published:
                    type: boolean
                  image_cover_url:
                    type: string
                    nullable: true
              example:
                id: SECTION_ID
                product_id: PROGRAM_ID
                section_group_id: GROUP_ID
                section_group_position: 1
                name: Introduction
                description: Start here
                position: 1
                drip_delay: 0
                is_published: false
                image_cover_url: null
        '401':
          description: Access denied
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    oneOf:
                      - type: string
                      - type: array
                        items:
                          type: string
              example:
                error: Access denied
        '403':
          description: You do not have permission to perform this action
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    oneOf:
                      - type: string
                      - type: array
                        items:
                          type: string
              example:
                error: You do not have permission to perform this action
        '404':
          description: Section, destination program or destination section group not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    oneOf:
                      - type: string
                      - type: array
                        items:
                          type: string
              example:
                error: Record not found
        '422':
          description: >-
            Invalid arguments On cross-program moves, existing questions require
            an enabled, published destination category of the same type. Inline
            Questions and Community share a type. The destination forum category
            must be open to receive questions. A Consultation question linked to
            a session in another category blocks the move.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    oneOf:
                      - type: string
                      - type: array
                        items:
                          type: string
                  code:
                    type: string
                    description: >-
                      Present when a move rule blocks the request.
                      questions_disabled means the destination cannot receive
                      existing questions. question_destination_mismatch means
                      the question types differ.
                      consultation_session_category_mismatch means an existing
                      question is linked to a session in another category.
              example:
                error: >-
                  Existing lesson questions need an available destination
                  category. Check Program Settings → Questions go to before
                  moving this content.
                code: questions_disabled
        '429':
          description: Too many requests
          content:
            text/plain:
              schema:
                type: string
              example: |
                Throttled
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.