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

# Start Studio

`PUT /studios/{sessionId}/start`

Starts the given Studio session ID.

## Path parameters

- `sessionId` string, required

## Query parameters

- `workspaceId` integer

## Request body

- DataStudioStartRequest
  - `configuration` DataStudioConfiguration
    - `gpu` integer
    - `cpu` integer
    - `memory` integer
    - `mountData` string[]
    - `environment` object, nullable
    - `condaEnvironment` string
    - `lifespanHours` integer
  - `description` string, nullable
  - `labelIds` integer[], nullable
  - `spot` boolean, nullable

## Response `200`

OK

- DataStudioStartResponse
  - `jobSubmitted` boolean, required
  - `sessionId` string, required
  - `statusInfo` DataStudioStatusInfo, required
    - `status` 'starting' | 'running' | 'stopping' | 'stopped' | 'errored' | 'building' | 'buildFailed'
    - `message` string
    - `lastUpdate` string, date-time

## 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.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/d86e2935c8e2/schema)