---
title: "Points an existing image slot (name, the relative path the html references, so it may contain slashes) at a tenant media library asset instead of an uploaded file. The reference is recorded on the node for the library's usage check. The editor swaps the url in the html itself afterwards."
method: PUT
path: "/api/simulations/{simulationId}/nodes/{nodeId}/code/images/{name}"
tags: ["CodeNode"]
---

# Points an existing image slot (name, the relative path the html references, so it may contain slashes) at a tenant media library asset instead of an uploaded file. The reference is recorded on the node for the library's usage check. The editor swaps the url in the html itself afterwards.

`PUT /api/simulations/{simulationId}/nodes/{nodeId}/code/images/{name}`

## 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}/code/images/{name}`
- 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
- `name` string, required

## Request body

- SelectMediaReferenceDto
  - `mediaReferenceId` string, uuid, required: A valid GUID

## Response `200`

OK

- CodeNodeDto
  - `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
  - `htmlUrl` string, nullable
  - `fileName` string, nullable
  - `images` CodeNodeImageDto[], required
    - `name` string, required
    - `url` string, required
    - `contentType` string, required
    - `sizeBytes` integer, required
    - `mediaReferenceId` string, nullable
  - `continueButton` NodeContinueButtonDto
    - `text` string, required
    - `buttonColor` ColorValue, required
      - `value` string, required
    - `textColor` ColorValue, required
      - `value` string, required
  - `background` QuizBackgroundDto
    - `type` 'Hex' | 'Image' | 'Gradient', required
    - `value` string, nullable
    - `imageId` string, uuid, nullable: A valid GUID
    - `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
    - `imageTransformation` ImageTransformationDto
      - `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
    - `fromHex` string, nullable
    - `toHex` string, nullable

---

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