---
title: "Changes to Update a Studio"
method: PUT
path: "/studios/{sessionId}"
---

# Changes to Update a Studio

`PUT /studios/{sessionId}`

> Every recorded change to this operation, newest first.
> 19 revisions in range; 1 not diffed.

## Timeline

Changed in 8 of 19 revisions.

- **2026-10-06** `0e1a1696f553`: 1 info
- **2026-09-28** `24f327d93421`: 8 breaking, 1 info
- **2026-09-25** `23c276ac7e55`: 3 info
- **2026-09-21** `ca2c61bb3604`: 9 breaking, 4 warning, 8 info
- **2026-08-25** `f1b3206690c9`: 1 warning, 2 info
- **2026-07-24** `13316c9fe5ff`: 1 info
- **2026-05-11** `61cfa2ccce46`: 1 info
- **2026-04-20** `b2b5cc41d473`: 1 info

## Changes

- **2026-10-06** `0e1a1696f553`: 1 info
  - added the optional property `mountedDataLinks/items/versioning` to the response with the `200` status
- **2026-09-28** `24f327d93421`: 8 breaking, 1 info
  - the response property `activeConnections/items/allOf[#/components/schemas/UserInfo]/avatar` became nullable for the status `200`
  - the response property `allowedUsers/items/avatar` became nullable for the status `200`
  - the response property `configuration/lifespanHours` became nullable for the status `200`
  - the response property `effectiveLifespanHours` became nullable for the status `200`
  - the response property `mountedDataLinks/items/description` became nullable for the status `200`
  - the response property `mountedDataLinks/items/message` became nullable for the status `200`
  - the response property `progress/items/warnings` became nullable for the status `200`
  - the response property `user/avatar` became nullable for the status `200`
  - the request property `configuration/allOf[#/components/schemas/DataStudioConfiguration]/lifespanHours` became nullable
- **2026-09-25** `23c276ac7e55`: 3 info
  - added the new optional request property `customIconId`
  - added the optional property `customIcon` to the response with the `200` status
  - added the optional property `customIconId` to the response with the `200` status
- **2026-09-21** `ca2c61bb3604`: 9 breaking, 4 warning, 8 info
  - the response property `baseImage` became nullable for the status `200`
  - the response property `configuration/condaEnvironment` became nullable for the status `200`
  - the response property `lastStarted` became nullable for the status `200`
  - the response property `parentCheckpoint` became nullable for the status `200`
  - the response property `progress` became nullable for the status `200`
  - the response property `statusInfo/stopReason` became nullable for the status `200`
  - the response property `waveBuildUrl` became nullable for the status `200`
  - the `parentCheckpoint` response's property type changed from `object` to no type for status `200`
  - the `statusInfo/stopReason` response's property type changed from `string` to no type for status `200`
  - removed the optional property `parentCheckpoint/checkpointId` from the response with the `200` status
  - removed the optional property `parentCheckpoint/checkpointName` from the response with the `200` status
  - removed the optional property `parentCheckpoint/sessionId` from the response with the `200` status
  - removed the optional property `parentCheckpoint/studioName` from the response with the `200` status
  - the request property `configuration/allOf[#/components/schemas/DataStudioConfiguration]/condaEnvironment` became nullable
  - added `#/components/schemas/DataStudioDto.ParentCheckpoint` to the `parentCheckpoint` response property `allOf` list for the response status `200`
  - added `#/components/schemas/DataStudioStopReason` to the `statusInfo/stopReason` response property `allOf` list for the response status `200`
  - removed the `CREDITS_RUN_OUT` enum value from the `statusInfo/stopReason` response property for the response status `200`
  - removed the `FORCE_STOPPED` enum value from the `statusInfo/stopReason` response property for the response status `200`
  - removed the `LIFESPAN_EXPIRED` enum value from the `statusInfo/stopReason` response property for the response status `200`
  - removed the `NO_STATS_AVAIL` enum value from the `statusInfo/stopReason` response property for the response status `200`
  - removed the `SPOT_RECLAMATION` enum value from the `statusInfo/stopReason` response property for the response status `200`
- **2026-08-25** `f1b3206690c9`: 1 warning, 2 info
  - added the new `FORCE_STOPPED` enum value to the `statusInfo/stopReason` response property for the response status `200`
  - added the optional property `starred` to the response with the `200` status
  - added the optional property `statusInfo/canForceStop` to the response with the `200` status
- **2026-07-24** `13316c9fe5ff`: 1 info
  - added the optional property `allowedUsers` to the response with the `200` status
- **2026-05-11** `61cfa2ccce46`: 1 info
  - added the new optional request property `computeEnvId`
- **2026-04-20** `b2b5cc41d473`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/seqeralabs/apis/seqera-api/docs/studios/:sessionId/put.md) - [API](https://skmtc.dev/seqeralabs/apis/seqera-api.md) - [Page](https://skmtc.dev/seqeralabs/apis/seqera-api/changes/studios/:sessionId/put)