---
title: "PUT /api/simulations/{simulationId}/nodes/{nodeId}/hotspot/spots/{spotId}/position"
method: PUT
path: "/api/simulations/{simulationId}/nodes/{nodeId}/hotspot/spots/{spotId}/position"
tags: ["HotspotNode"]
---

# PUT /api/simulations/{simulationId}/nodes/{nodeId}/hotspot/spots/{spotId}/position

`PUT /api/simulations/{simulationId}/nodes/{nodeId}/hotspot/spots/{spotId}/position`

## 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}/hotspot/spots/{spotId}/position`
- 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
- `spotId` string, uuid, required: A valid GUID

## Request body

- Position2dDto
  - `x` number, double, required
  - `y` number, double, required

## Response `200`

OK

- SpotDto
  - `id` string, uuid, required: A valid GUID
  - `position` Position2dDto, required
    - `x` number, double, required
    - `y` number, double, required
  - `visualSettings` SpotVisualSettingsDto, required
    - `type` 'Basic' | 'Icon' | 'Custom', required
    - `width` number, float, required
    - `height` number, float, required
    - `rotation` number, float, required
  - `label` string, required
  - `contentText` SpotContentTextDto, required
    - `textHtml` string, required
    - `textPlain` string, nullable
    - `enabled` boolean, required
  - `shapeText` SpotShapeTextDto
    - `textHtml` string, required
    - `textPlain` string, nullable
  - `backgroundColor` ColorValue, required
    - `value` string, required
  - `image` SpotImageDto
    - `enabled` boolean, 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
    - `transformation` ImageTransformationDto, required
      - `imageTranslation` Position2dDto, required
        - `x` number, double, required
        - `y` number, double, required
      - `imageScale` ImageScaleDto, required
        - `x` number, double, required
        - `y` number, double, required
      - `rotation` number, double, required
      - `maskDimensions` MaskDimensionsDto, required
        - `width` number, double, required
        - `height` number, double, required
  - `navigationTrigger` TriggerDto, required
    - `type` 'Button' | 'Click', required
    - `nodeContinueButton` NodeContinueButtonDto, required
      - `text` string, required
      - `buttonColor` ColorValue, required
        - `value` string, required
      - `textColor` ColorValue, required
        - `value` string, required
    - `url` string, nullable
    - `enabled` boolean, required
    - `openInNewTab` boolean, required
    - `navigationType` 'Url' | 'Node', required
    - `targetNodeId` string, uuid, nullable: A valid GUID
  - `hideAfterClick` boolean, required
  - `disableHoverEffect` boolean, required
  - `disablePointerCursor` boolean, required
  - `readTextAloud` boolean, required
  - `readAloudAudio` SpotReadAloudAudioDto
    - `url` string, required
    - `duration` number, float, nullable
  - `readAloudVoice` SpotReadAloudVoiceDto
    - `voiceShortName` string, required
    - `locale` string, required
  - `autoplayVideo` boolean, required
  - `confettiOnClick` boolean, required
  - `confettiStyle` 'Confetti' | 'Fireworks', required
  - `popupPlacementOverride` 'Relative' | 'Center'
  - `popupAnimationOverride` 'Scale' | 'None' | 'Fade' | 'Pop' | 'Slide' | 'Bounce' | 'Flip'
  - `popupAnimationDirectionOverride` 'Up' | 'Down' | 'Left' | 'Right'
  - `popupAnimationSpeedOverride` 'Normal' | 'Fast' | 'Slow'

---

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