---
title: "Updating Node item"
method: PUT
path: "/api/simulations/{simulationId}/nodes/{nodeId}"
tags: ["Node"]
---

# Updating Node item

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

## 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}`
- Auth: OAuth 2
  - Implicit: `https://login.wearelearning.io/authorize?audience=https://api.wearelearning.io`

Updates an existing item

## Path parameters

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

## Request body

- EditNodeDto
  - `id` string, nullable
  - `label` string, nullable
  - `text` string, nullable
  - `color` string, nullable
  - `eventId` string, nullable
  - `nodeType` 'dialogue' | 'response' | 'poster' | 'event' | 'end' | 'open-response' | 'outcome' | 'no-match' | 'hotspot' | 'quiz' | 'page' | 'code', required
  - `position` Position2dDto
    - `x` number, double, required
    - `y` number, double, required
  - `speakerIndex` string, nullable
  - `speakerId` string, nullable
  - `timelineDuration` number, float, nullable
  - `shouldDoAiRephrase` boolean, required
  - `audioTimelineStartTime` number, double, nullable
  - `audioType` 'None' | 'Recording' | 'TextToSpeech' | 'Upload'
  - `audioGuid` string, nullable
  - `sceneBackground` string, nullable
  - `selectedSceneId` string, nullable
  - `consequences` ConsequenceDto[], nullable
    - `skillId` string, uuid, required: A valid GUID
    - `enabled` boolean, required
    - `value` integer, required
    - `showEffect` boolean, required
    - `index` string, required
  - `voiceoverEnabled` boolean, required
  - `randomResponseOrder` boolean, required
  - `ambienceVolume` number, float, nullable
  - `isSuccess` boolean, nullable
  - `displayPosterIcon` boolean, nullable
  - `camera` CameraDto
    - `zoom` number, double, required
    - `panX` number, double, required
    - `panY` number, double, required
  - `references` string[], nullable
  - `sequence` EventSequenceItemDto[], nullable
    - `action` 'AddCharacter' | 'RemoveCharacter' | 'EditLocation', required
    - `relationship` 'With' | 'After', required
    - `order` integer, required
    - `showDelay` integer, required
    - `location` string, nullable
    - `character` EventSequenceCharacterDto
      - `id` string, required
      - `name` string, required
    - `transition` EventSequenceTransitionDto
      - `type` 'FadeIn' | 'WalkIn' | 'WalkOut', required
      - `direction` 'Left' | 'Right'
      - `duration` integer, required
  - `characters` NodeCharacterDto[], nullable
    - `id` string, required
    - `position` ThreeDimensionalPositionDto, required
      - `x` number, double, required
      - `y` number, double, required
      - `z` number, double, required
    - `rotation` number, float, required
    - `pose` 'Standing' | 'Sitting' | 'Desk', required
    - `dialogueNodeOverrides` DialogueNodeCharacterOverridesDto
      - `positionOverride` boolean, required
      - `rotationOverride` boolean, required
      - `hidden` boolean, required
  - `location` string, nullable
  - `timeOfDay` number, float, nullable
  - `indoorLighting` ColorDto
    - `r` number, float, nullable
    - `g` number, float, nullable
    - `b` number, float, nullable
    - `brightness` number, float, nullable
  - `audioVolume` number, float, nullable
  - `speakingStyles` CharacterSpeakingStyleDto[], nullable
    - `characterId` string, required
    - `style` string, required
    - `pitch` integer, required
    - `rate` integer, required
  - `posterNodeParameters` PosterNodeParametersDto
    - `selectedTemplate` 'TextOnly' | 'ImageText' | 'TextImage' | 'IconTextVertical' | 'IconText' | 'Image', required
    - `displayPosterIcon` boolean, required
    - `color` string, required
    - `showFullscreen` boolean, required
    - `images` PosterImageDto[], required
      - `url` string, required
      - `thumbnailImageUrl` string, nullable
      - `desktopImageUrl` string, nullable
      - `mobileImageUrl` string, nullable
      - `position` Position2dDto, required
        - `x` number, double, required
        - `y` number, double, required
      - `scale` SingleSingleTuple, required
        - `item1` number, float, required
        - `item2` number, float, required
      - `rotation` number, float, required
      - `opacity` number, float, required
      - `mediaReferenceId` string, uuid, required: A valid GUID
      - `mediaReference` 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
    - `button` PosterNodeButtonDto, required
      - `text` string, required
      - `textColor` string, required
      - `backgroundColor` string, required
    - `background` PosterBackgroundDto, required
      - `type` 'Hex' | 'Image' | 'Gradient', required
      - `value` string, nullable
      - `backgroundImage` PosterImageDto
        - `url` string, required
        - `thumbnailImageUrl` string, nullable
        - `desktopImageUrl` string, nullable
        - `mobileImageUrl` string, nullable
        - `position` Position2dDto, required
          - `x` number, double, required
          - `y` number, double, required
        - `scale` SingleSingleTuple, required
          - `item1` number, float, required
          - `item2` number, float, required
        - `rotation` number, float, required
        - `opacity` number, float, required
        - `mediaReferenceId` string, uuid, required: A valid GUID
        - `mediaReference` 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
      - `fromHex` string, nullable
      - `toHex` string, nullable
    - `text` string, required
    - `textJson` string, required
    - `icon` PosterNodeIconDto
      - `url` string, required
      - `color` string, required
      - `absoluteUrl` string, nullable
    - `selectedMediaType` 'Image' | 'Video', required
    - `video` PosterVideoDto, required
      - `mediaReference` 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
      - `externalVideoUrl` string, uri, nullable
      - `videoType` 'None' | 'Embed' | 'Upload', required
      - `mandatoryPlaythrough` boolean, required
      - `autoplay` boolean, required
      - `autoContinueOnEnd` boolean, required
  - `dialogueNodeOverrides` DialogueNodeOverridesDto
    - `cameraZoomOverride` boolean, required
    - `ambienceVolumeOverride` boolean, required

## Response `200`

OK

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error

---

[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)