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

# Updating Simulation item

`PUT /api/simulations/{simulationId}`

## 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}`
- 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

## Request body

- EditSimulationDto
  - `title` string, required
  - `languageCode` string, required
  - `description` string, nullable
  - `skillExplorerEnabled` boolean, nullable
  - `skills` SkillDto[], nullable
    - `id` string, uuid, nullable: A valid GUID
    - `name` string, required
    - `showEffect` boolean, required
    - `feedbacks` FeedbackDto[], required
      - `index` string, required
      - `value` string, required
      - `range` RangeDto, required
        - `minValue` integer, required
        - `maxValue` integer, required
  - `gradient` 'gradient_1' | 'gradient_2' | 'gradient_3' | 'gradient_4' | 'gradient_5', required
  - `characters` UpsertSimulationCharacterDto[], nullable
    - `id` string, nullable
    - `selectedVoiceName` string, nullable
    - `name` string, nullable
    - `role` string, nullable
    - `desiredOutcomeFromConversation` string, nullable
    - `actsLike` string, nullable
    - `isPlayer` boolean, nullable
    - `position` ThreeDimensionalPositionDto
      - `x` number, double, required
      - `y` number, double, required
      - `z` number, double, required
  - `voiceover` EditVoiceOverDto
    - `enabled` boolean, required
    - `selectedVoiceName` string, required
    - `gender` 'Female' | 'Male', required
  - `characterIds` string[], nullable
  - `storyType` string, nullable
  - `storyDescription` string, nullable
  - `muteAmbienceSounds` boolean, nullable

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