---
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
    - `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'

## Other responses

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

---

[API](https://skmtc.net/seqeralabs/apis/seqera-api.md) · [All operations](https://skmtc.net/seqeralabs/apis/seqera-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/seqeralabs/seqera-api/versions/13316c9fe5ff/schema)