---
title: "Create Studio"
method: POST
path: "/studios"
tags: ["studios"]
---

# Create Studio

`POST /studios`

Creates a new Studio environment, starting it by default. Default behavior can be changed using the query parameter `autoStart=false`.

## Query parameters

- `workspaceId` integer
- `autoStart` boolean

## Request body

- DataStudioCreateRequest
  - `name` string, required
  - `description` string
  - `dataStudioToolUrl` string, required
  - `computeEnvId` string, required
  - `initialCheckpointId` integer
  - `configuration` DataStudioConfiguration
    - `gpu` integer
    - `cpu` integer
    - `memory` integer
    - `mountData` string[]
    - `environment` object, nullable
    - `condaEnvironment` string
    - `lifespanHours` integer
  - `isPrivate` boolean
  - `labelIds` integer[], nullable
  - `spot` boolean, nullable

## Response `200`

Create Studio 200 response

- DataStudioCreateResponse
  - `studio` DataStudioDto
    - `sessionId` string
    - `workspaceId` integer
    - `parentCheckpoint` DataStudioDtoParentCheckpoint
      - `checkpointId` integer
      - `checkpointName` string
      - `sessionId` string
      - `studioName` string
    - `user` StudioUser
      - `id` integer, required
      - `userName` string, required
      - `email` string, required
      - `avatar` string, required
    - `name` string
    - `description` string
    - `studioUrl` string
    - `computeEnv` DataStudioComputeEnvDto
      - `id` string
      - `name` string
      - `platform` string
      - `region` string
      - `credentialsId` string
      - `workDir` string
    - `template` DataStudioTemplate
      - `repository` string
      - `icon` string
      - `status` 'recommended' | 'deprecated' | 'experimental' | 'unsupported'
      - `tool` string
    - `configuration` DataStudioConfiguration
      - `gpu` integer
      - `cpu` integer
      - `memory` integer
      - `mountData` string[]
      - `environment` object, nullable
      - `condaEnvironment` string
      - `lifespanHours` integer
    - `dateCreated` string, date-time
    - `lastUpdated` string, date-time
    - `lastStarted` string, date-time
    - `effectiveLifespanHours` integer
    - `activeConnections` ActiveConnection[]
      - `id` integer, required
      - `userName` string, required
      - `email` string, required
      - `avatar` string, required
      - `lastActive` string, date-time, required
    - `statusInfo` DataStudioStatusInfo
      - `status` 'starting' | 'running' | 'stopping' | 'stopped' | 'errored' | 'building' | 'buildFailed'
      - `message` string
      - `lastUpdate` string, date-time
    - `waveBuildUrl` string
    - `baseImage` string
    - `customImage` boolean
    - `isPrivate` boolean
    - `mountedDataLinks` DataLinkDto[]
      - `id` string
      - `name` string
      - `description` string
      - `resourceRef` string
      - `type` 'bucket'
      - `provider` 'aws' | 'google' | 'azure' | 'azure_entra' | 'azure-cloud' | 'seqeracompute'
      - `region` string
      - `credentials` DataLinkCredentials[]
        - `id` string, required
        - `name` string, required
        - `provider` 'aws' | 'google' | 'azure' | 'azure_entra' | 'azure-cloud' | 'seqeracompute', required
      - `publicAccessible` boolean
      - `hidden` boolean
      - `status` 'VALID' | 'INVALID'
      - `message` string
    - `progress` DataStudioProgressStep[]
      - `status` 'pending' | 'in-progress' | 'succeeded' | 'errored'
      - `message` string
      - `warnings` string[]
    - `labels` LabelDbDto[], nullable
      - `id` integer
      - `name` string
      - `value` string
      - `resource` boolean
      - `isDefault` boolean
      - `isDynamic` boolean
      - `isInterpolated` boolean
      - `dateCreated` string, date-time

## Other responses

- `201` — Created
- `400` — BadRequest
- `403` — Operation not allowed
- `404` — NotFound, when the workspace or compute environment is not found or when the API is disabled.
- `409` — Conflict - duplicated name

---

[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)