---
title: "Starts a Studio"
method: PUT
path: "/studios/{sessionId}/start"
tags: ["studios"]
---

# Starts a Studio

`PUT /studios/{sessionId}/start`

Starts the given Studio session ID.

## Path parameters

- `sessionId` string, required

## Query parameters

- `workspaceId` integer

## Request body

- DataStudioStartRequest
  - `allowedUserIds` integer[], nullable
  - `configuration` DataStudioConfiguration
    - `condaEnvironment` string
    - `cpu` integer
    - `environment` object, nullable
    - `gpu` integer
    - `lifespanHours` integer
    - `memory` integer
    - `mountData` string[], nullable
    - `mountDataV2` MountData[], nullable
      - `dataLinkId` string
      - `path` string, nullable
    - `sshEnabled` boolean, nullable
  - `description` string, nullable
  - `labelIds` integer[], nullable
  - `name` string, nullable
  - `spot` boolean, nullable

## Response `200`

OK

- DataStudioStartResponse
  - `jobSubmitted` boolean, required
  - `sessionId` string, required
  - `statusInfo` DataStudioStatusInfo, required
    - `canForceStop` boolean
    - `lastUpdate` string, date-time
    - `message` string
    - `status` 'starting' | 'running' | 'stopping' | 'stopped' | 'errored' | 'building' | 'buildFailed'
    - `stopReason` 'CREDITS_RUN_OUT' | 'LIFESPAN_EXPIRED' | 'SPOT_RECLAMATION' | 'NO_STATS_AVAIL' | 'FORCE_STOPPED'

## Other responses

- `403` — Operation not allowed.
- `404` — NotFound, when the Studio is not found or when the API is disabled for the workspace.

## Changes

> 14 revisions in range; 1 not diffed, 3 could not be searched.

- **2026-04-20** `b2b5cc41d473` — 1 info
  - added the new optional request property `name`
- **2026-03-10** `49c99a6944de` — 4 info
  - added the new optional request property `configuration/allOf[#/components/schemas/DataStudioConfiguration]/mountDataV2`
  - added the new optional request property `configuration/allOf[#/components/schemas/DataStudioConfiguration]/sshEnabled`
  - the request property `configuration/allOf[#/components/schemas/DataStudioConfiguration]/mountData` became nullable
  - request property `configuration/allOf[#/components/schemas/DataStudioConfiguration]/mountData` deprecated
- **2026-01-20** `98d6b538c88e` — 1 info
  - added the optional property `statusInfo/stopReason` to the response with the `200` status

[Change history](https://skmtc.dev/seqeralabs/apis/seqera-api/changes/studios/:sessionId/start/put.md)

---

[API](https://skmtc.dev/seqeralabs/apis/seqera-api.md) · [All operations](https://skmtc.dev/seqeralabs/apis/seqera-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/seqeralabs/seqera-api/revisions/97f7655d105a/schema)