---
title: "Adds media tracks to a node"
method: PUT
path: "/api/simulations/{simulationId}/nodes/{nodeId}/media/tracks"
tags: ["Node"]
---

# Adds media tracks to a node

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

## 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}/media/tracks`
- 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

- UpdateMediaTracksDto
  - `mediaTracks` MediaTrackDto[], required
    - `id` string, required
    - `mediaClipIds` string[], required
  - `mediaClips` MediaClipDto[], required
    - `id` string, required
    - `startTime` number, float, required
    - `endTime` number, float, required
    - `url` string, required
    - `fileName` string, required
    - `position` ThreeDimensionalPositionDtoWithOptionalZValue, required
      - `x` integer, required
      - `y` integer, required
      - `z` integer, nullable
    - `size` integer, required
    - `opacity` integer, nullable
    - `rotation` integer, nullable
    - `transition` 'Fade' | 'Instant' | 'Move' | 'Pop' | 'Drop'
    - `animations` MediaAnimation[], nullable
      - `type` 'Start' | 'End', required
      - `transition` 'Fade' | 'Instant' | 'Move' | 'Pop' | 'Drop', required
      - `direction` 'Top' | 'Right' | 'Bottom' | 'Left'
    - `positionDepth` 'Back' | 'Front'
    - `sceneBackgroundDimness` integer, required

## Response `200`

If updated

- string

## Other responses

- `401`: If unauthorized access
- `404`: If the node can't be found
- `412`: If the item had been updated since sending the request
- `500`: If something went wrong

---

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