---
title: "Changes to Create Studio"
method: POST
path: "/studios"
---

# Changes to Create Studio

`POST /studios`

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

## Timeline

Changed in 9 of 19 revisions.

- **2026-10-06** `0e1a1696f553`: 2 info
- **2026-09-28** `24f327d93421`: 16 breaking, 1 info
- **2026-09-25** `23c276ac7e55`: 5 info
- **2026-09-21** `ca2c61bb3604`: 18 breaking, 8 warning, 15 info
- **2026-08-25** `f1b3206690c9`: 2 warning, 4 info
- **2026-07-24** `13316c9fe5ff`: 3 info
- **2026-04-20** `b2b5cc41d473`: 4 breaking
- **2026-03-10** `49c99a6944de`: 4 breaking, 12 info
- **2026-01-20** `98d6b538c88e`: 12 breaking, 4 warning, 15 info

## Changes

- **2026-10-06** `0e1a1696f553`: 2 info
  - added the optional property `studio/mountedDataLinks/items/versioning` to the response with the `200` status
  - added the optional property `studio/mountedDataLinks/items/versioning` to the response with the `201` status
- **2026-09-28** `24f327d93421`: 16 breaking, 1 info
  - the response property `studio/activeConnections/items/allOf[#/components/schemas/UserInfo]/avatar` became nullable for the status `200`
  - the response property `studio/activeConnections/items/allOf[#/components/schemas/UserInfo]/avatar` became nullable for the status `201`
  - the response property `studio/allowedUsers/items/avatar` became nullable for the status `200`
  - the response property `studio/allowedUsers/items/avatar` became nullable for the status `201`
  - the response property `studio/configuration/lifespanHours` became nullable for the status `200`
  - the response property `studio/configuration/lifespanHours` became nullable for the status `201`
  - the response property `studio/effectiveLifespanHours` became nullable for the status `200`
  - the response property `studio/effectiveLifespanHours` became nullable for the status `201`
  - the response property `studio/mountedDataLinks/items/description` became nullable for the status `200`
  - the response property `studio/mountedDataLinks/items/description` became nullable for the status `201`
  - the response property `studio/mountedDataLinks/items/message` became nullable for the status `200`
  - the response property `studio/mountedDataLinks/items/message` became nullable for the status `201`
  - the response property `studio/progress/items/warnings` became nullable for the status `200`
  - the response property `studio/progress/items/warnings` became nullable for the status `201`
  - the response property `studio/user/avatar` became nullable for the status `200`
  - the response property `studio/user/avatar` became nullable for the status `201`
  - the request property `configuration/lifespanHours` became nullable
- **2026-09-25** `23c276ac7e55`: 5 info
  - added the new optional request property `customIconId`
  - added the optional property `studio/customIcon` to the response with the `200` status
  - added the optional property `studio/customIcon` to the response with the `201` status
  - added the optional property `studio/customIconId` to the response with the `200` status
  - added the optional property `studio/customIconId` to the response with the `201` status
- **2026-09-21** `ca2c61bb3604`: 18 breaking, 8 warning, 15 info
  - the response property `studio/baseImage` became nullable for the status `200`
  - the response property `studio/baseImage` became nullable for the status `201`
  - the response property `studio/configuration/condaEnvironment` became nullable for the status `200`
  - the response property `studio/configuration/condaEnvironment` became nullable for the status `201`
  - the response property `studio/lastStarted` became nullable for the status `200`
  - the response property `studio/lastStarted` became nullable for the status `201`
  - the response property `studio/parentCheckpoint` became nullable for the status `200`
  - the response property `studio/parentCheckpoint` became nullable for the status `201`
  - the response property `studio/progress` became nullable for the status `200`
  - the response property `studio/progress` became nullable for the status `201`
  - the response property `studio/statusInfo/stopReason` became nullable for the status `200`
  - the response property `studio/statusInfo/stopReason` became nullable for the status `201`
  - the response property `studio/waveBuildUrl` became nullable for the status `200`
  - the response property `studio/waveBuildUrl` became nullable for the status `201`
  - the `studio/parentCheckpoint` response's property type changed from `object` to no type for status `200`
  - the `studio/parentCheckpoint` response's property type changed from `object` to no type for status `201`
  - the `studio/statusInfo/stopReason` response's property type changed from `string` to no type for status `200`
  - the `studio/statusInfo/stopReason` response's property type changed from `string` to no type for status `201`
  - removed the optional property `studio/parentCheckpoint/checkpointId` from the response with the `200` status
  - removed the optional property `studio/parentCheckpoint/checkpointId` from the response with the `201` status
  - removed the optional property `studio/parentCheckpoint/checkpointName` from the response with the `200` status
  - removed the optional property `studio/parentCheckpoint/checkpointName` from the response with the `201` status
  - removed the optional property `studio/parentCheckpoint/sessionId` from the response with the `200` status
  - removed the optional property `studio/parentCheckpoint/sessionId` from the response with the `201` status
  - removed the optional property `studio/parentCheckpoint/studioName` from the response with the `200` status
  - removed the optional property `studio/parentCheckpoint/studioName` from the response with the `201` status
  - the request property `configuration/condaEnvironment` became nullable
  - added `#/components/schemas/DataStudioDto.ParentCheckpoint` to the `studio/parentCheckpoint` response property `allOf` list for the response status `200`
  - added `#/components/schemas/DataStudioDto.ParentCheckpoint` to the `studio/parentCheckpoint` response property `allOf` list for the response status `201`
  - added `#/components/schemas/DataStudioStopReason` to the `studio/statusInfo/stopReason` response property `allOf` list for the response status `200`
  - added `#/components/schemas/DataStudioStopReason` to the `studio/statusInfo/stopReason` response property `allOf` list for the response status `201`
  - removed the `CREDITS_RUN_OUT` enum value from the `studio/statusInfo/stopReason` response property for the response status `200`
  - removed the `CREDITS_RUN_OUT` enum value from the `studio/statusInfo/stopReason` response property for the response status `201`
  - removed the `FORCE_STOPPED` enum value from the `studio/statusInfo/stopReason` response property for the response status `200`
  - removed the `FORCE_STOPPED` enum value from the `studio/statusInfo/stopReason` response property for the response status `201`
  - removed the `LIFESPAN_EXPIRED` enum value from the `studio/statusInfo/stopReason` response property for the response status `200`
  - removed the `LIFESPAN_EXPIRED` enum value from the `studio/statusInfo/stopReason` response property for the response status `201`
  - removed the `NO_STATS_AVAIL` enum value from the `studio/statusInfo/stopReason` response property for the response status `200`
  - removed the `NO_STATS_AVAIL` enum value from the `studio/statusInfo/stopReason` response property for the response status `201`
  - removed the `SPOT_RECLAMATION` enum value from the `studio/statusInfo/stopReason` response property for the response status `200`
  - …1 more
- **2026-08-25** `f1b3206690c9`: 2 warning, 4 info
  - added the new `FORCE_STOPPED` enum value to the `studio/statusInfo/stopReason` response property for the response status `200`
  - added the new `FORCE_STOPPED` enum value to the `studio/statusInfo/stopReason` response property for the response status `201`
  - added the optional property `studio/starred` to the response with the `200` status
  - added the optional property `studio/starred` to the response with the `201` status
  - added the optional property `studio/statusInfo/canForceStop` to the response with the `200` status
  - added the optional property `studio/statusInfo/canForceStop` to the response with the `201` status
- **2026-07-24** `13316c9fe5ff`: 3 info
  - added the new optional request property `allowedUserIds`
  - added the optional property `studio/allowedUsers` to the response with the `200` status
  - added the optional property `studio/allowedUsers` to the response with the `201` status
- **2026-04-20** `b2b5cc41d473`: 4 breaking
  - the `studio/activeConnections/items/allOf[subschema #2]/` response's property type changed from no type to `object` for status `200`
  - the `studio/activeConnections/items/allOf[subschema #2]/` response's property type changed from no type to `object` for status `201`
  - the `studio/computeEnv/allOf[subschema #2]/` response's property type changed from no type to `object` for status `200`
  - the `studio/computeEnv/allOf[subschema #2]/` response's property type changed from no type to `object` for status `201`
- **2026-03-10** `49c99a6944de`: 4 breaking, 12 info
  - the response property `studio/configuration/mountData` became nullable for the status `200`
  - the response property `studio/configuration/mountData` became nullable for the status `201`
  - the `studio/mountedDataLinks/items/status` response's property type changed from `string` to no type for status `200`
  - the `studio/mountedDataLinks/items/status` response's property type changed from `string` to no type for status `201`
  - added the new optional request property `configuration/mountDataV2`
  - added the new optional request property `configuration/sshEnabled`
  - the request property `configuration/mountData` became nullable
  - request property `configuration/mountData` deprecated
  - added the optional property `studio/configuration/mountDataV2` to the response with the `200` status
  - added the optional property `studio/configuration/mountDataV2` to the response with the `201` status
  - added the optional property `studio/configuration/sshEnabled` to the response with the `200` status
  - added the optional property `studio/configuration/sshEnabled` to the response with the `201` status
  - added the optional property `studio/sshDetails` to the response with the `200` status
  - added the optional property `studio/sshDetails` to the response with the `201` status
  - response property `studio/configuration/mountData` deprecated
  - response property `studio/configuration/mountData` deprecated
- **2026-01-20** `98d6b538c88e`: 12 breaking, 4 warning, 15 info
  - the response property `studio/activeConnections/items/allOf[subschema #2]/lastActive` became optional for the status `200`
  - the response property `studio/activeConnections/items/allOf[subschema #2]/lastActive` became optional for the status `201`
  - the response property `studio/user/avatar` became optional for the status `200`
  - the response property `studio/user/avatar` became optional for the status `201`
  - the response property `studio/user/email` became optional for the status `200`
  - the response property `studio/user/email` became optional for the status `201`
  - the response property `studio/user/id` became optional for the status `200`
  - the response property `studio/user/id` became optional for the status `201`
  - the response property `studio/user/userName` became optional for the status `200`
  - the response property `studio/user/userName` became optional for the status `201`
  - the `studio/mountedDataLinks/items/status` response's property type changed from no type to `string` for status `200`
  - the `studio/mountedDataLinks/items/status` response's property type changed from no type to `string` for status `201`
  - added the new `s3` enum value to the `studio/mountedDataLinks/items/credentials/items/provider` response property for the response status `200`
  - added the new `s3` enum value to the `studio/mountedDataLinks/items/credentials/items/provider` response property for the response status `201`
  - added the new `s3` enum value to the `studio/mountedDataLinks/items/provider` response property for the response status `200`
  - added the new `s3` enum value to the `studio/mountedDataLinks/items/provider` response property for the response status `201`
  - added the new optional request property `remoteConfig`
  - the request property `dataStudioToolUrl` became optional
  - the `dataStudioToolUrl` request property's minLength was decreased from `1` to `0`
  - added the optional property `studio/remoteConfig` to the response with the `200` status
  - added the optional property `studio/remoteConfig` to the response with the `201` status
  - added the optional property `studio/statusInfo/stopReason` to the response with the `200` status
  - added the optional property `studio/statusInfo/stopReason` to the response with the `201` status
  - the response optional property `studio/mountedDataLinks/items/status` became read-only for the status `200`
  - the response optional property `studio/mountedDataLinks/items/status` became read-only for the status `201`
  - added `#/components/schemas/UserInfo` to the `studio/activeConnections/items/` response property `allOf` list for the response status `200`
  - added `#/components/schemas/UserInfo` to the `studio/activeConnections/items/` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/StudioUser` from the `studio/activeConnections/items/` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/StudioUser` from the `studio/activeConnections/items/` response property `allOf` list for the response status `201`
  - removed `subschema #2` from the `studio/mountedDataLinks/items/status` response property `allOf` list for the response status `200`
  - removed `subschema #2` from the `studio/mountedDataLinks/items/status` response property `allOf` list for the response status `201`

---

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