---
title: "Full page tree replacement. Since WE-1985 block, column and order edits go through the granular endpoints below; this remains for the compound edits no targeted endpoint expresses — inserting a templated section and restructuring a section's columns to a layout preset."
method: PUT
path: "/api/simulations/{simulationId}/nodes/{nodeId}/page"
tags: ["PageNode"]
---

# Full page tree replacement. Since WE-1985 block, column and order edits go through the granular endpoints below; this remains for the compound edits no targeted endpoint expresses — inserting a templated section and restructuring a section's columns to a layout preset.

`PUT /api/simulations/{simulationId}/nodes/{nodeId}/page`

## Request

- Base URL: `https://api.wearelearning.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wearelearning.io/api/simulations/{simulationId}/nodes/{nodeId}/page`
- Auth: OAuth 2
  - Implicit: `https://login.wearelearning.io/authorize?audience=https://api.wearelearning.io`

## Path parameters

- `simulationId` string, uuid, required: A valid GUID
- `nodeId` string, uuid, required: A valid GUID

## Request body

- UpdatePageNodeDto
  - `pages` PageDto[], required
    - `id` string, uuid, required: A valid GUID
    - `name` string, required
    - `themeId` string, uuid, nullable: A valid GUID
    - `sections` PageSectionDto[], required
      - `id` string, uuid, required: A valid GUID
      - `padding` integer, required
      - `columnGap` integer, required
      - `blockAlignment` string, required
      - `background` SectionBackgroundDto, required
        - `type` string, required
        - `color` string, nullable
        - `fromHex` string, nullable
        - `toHex` string, nullable
        - `angle` integer, nullable
        - `attachment` string, nullable
        - `mediaReferenceId` string, nullable
        - `imageReference` MediaReferenceDto
          - `id` string, required
          - `fileName` string, required
          - `extension` string, required
          - `contentType` string, required
          - `url` string, required
          - `publicUrl` string, required
          - `thumbnailUrl` string, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
          - `metadata` MetadataDto, required
            - `type` 'Image' | 'ImageVersion' | 'Video' | 'Audio' | 'Document', required
            - `size` integer, nullable
          - `folderId` string, uuid, nullable: A valid GUID
      - `columns` SectionColumnDto[], required
        - `id` string, required
        - `width` number, double, required
        - `padding` integer, required
        - `gap` integer, required
        - `blocks` PageBlockDto[], required
          - `id` string, required
          - `type` string, required
          - `data` union
            - RichTextBlockContentDto
              - …
            - MediaBlockContentDto
              - …
            - ButtonBlockContentDto
              - …
            - SpacerBlockContentDto
              - …
            - DividerBlockContentDto
              - …
            - CalloutBlockContentDto
              - …
            - EmbedBlockContentDto
              - …
            - FlashcardBlockContentDto
              - …
            - ImageComparisonBlockContentDto
              - …
            - CarouselBlockContentDto
              - …

## Response `200`

OK

- PageNodeDto
  - `nodeType` 'dialogue' | 'response' | 'poster' | 'event' | 'end' | 'open-response' | 'outcome' | 'no-match' | 'hotspot' | 'quiz' | 'page' | 'code', required
  - `id` string, required
  - `simulationId` string, required
  - `position` Position2dDto, required
    - `x` number, double, required
    - `y` number, double, required
  - `label` string, required
  - `sceneBackground` string, required
  - `pages` PageDto[], required
    - `id` string, uuid, required: A valid GUID
    - `name` string, required
    - `themeId` string, uuid, nullable: A valid GUID
    - `sections` PageSectionDto[], required
      - `id` string, uuid, required: A valid GUID
      - `padding` integer, required
      - `columnGap` integer, required
      - `blockAlignment` string, required
      - `background` SectionBackgroundDto, required
        - `type` string, required
        - `color` string, nullable
        - `fromHex` string, nullable
        - `toHex` string, nullable
        - `angle` integer, nullable
        - `attachment` string, nullable
        - `mediaReferenceId` string, nullable
        - `imageReference` MediaReferenceDto
          - `id` string, required
          - `fileName` string, required
          - `extension` string, required
          - `contentType` string, required
          - `url` string, required
          - `publicUrl` string, required
          - `thumbnailUrl` string, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
          - `metadata` MetadataDto, required
            - `type` 'Image' | 'ImageVersion' | 'Video' | 'Audio' | 'Document', required
            - `size` integer, nullable
          - `folderId` string, uuid, nullable: A valid GUID
      - `columns` SectionColumnDto[], required
        - `id` string, required
        - `width` number, double, required
        - `padding` integer, required
        - `gap` integer, required
        - `blocks` PageBlockDto[], required
          - `id` string, required
          - `type` string, required
          - `data` union
            - RichTextBlockContentDto
              - …
            - MediaBlockContentDto
              - …
            - ButtonBlockContentDto
              - …
            - SpacerBlockContentDto
              - …
            - DividerBlockContentDto
              - …
            - CalloutBlockContentDto
              - …
            - EmbedBlockContentDto
              - …
            - FlashcardBlockContentDto
              - …
            - ImageComparisonBlockContentDto
              - …
            - CarouselBlockContentDto
              - …

---

[API](https://skmtc.dev/wearelearning/apis/we-are-learning-api.md) - [All operations](https://skmtc.dev/wearelearning/apis/we-are-learning-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wearelearning/apis/we-are-learning-api/revisions/e2ca5265db77?raw)