---
title: "Create Session"
method: POST
path: "/v1/sessions"
---

# Create Session

`POST /v1/sessions`

## Request

- Base URL: `https://api.dreamscalelabs.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dreamscalelabs.com/v1/sessions`
- Auth: none declared

## Request body

- CreateSessionBody
  - `model` string, required
  - `provider` 'aws' | 'modal', nullable
  - `speed` 'standard' | 'fast', nullable
  - `region_mode` 'custom' | 'nearest' | 'available', nullable
  - `preferred_region` string, nullable
  - `region_pin` boolean
  - `region_order` string[], nullable
  - `region_order_source` 'client_https_rtt', nullable
  - `region_measurements` RegionMeasurementBody[]
    - `region` string, required
    - `median_ms` number, nullable
    - `mad_ms` number, nullable
    - `successful_samples` integer, required
    - `attempted_samples` integer, required
  - `region_probe_status` 'ok' | 'degraded' | 'failed', nullable
  - `region_probe_confident_winner` string, nullable
  - `optimization_config` OptimizationIntent
    - `acceleration` 'auto' | 'pytorch' | 'tensorrt'
    - `control` 'auto' | 'adaptive' | 'prefer_freshness' | 'balanced' | 'prefer_robustness' | 'ultra_aggressive'
    - `rtc` 'auto' | 'off' | 'on' | 'inference_time' | 'train_time'
    - `calibration` 'auto' | 'off' | 'fast' | 'default' | 'rtc_graph' | 'extended'
  - `idle_timeout` integer, nullable
  - `keep_warm` integer
  - `checkpoint` string, nullable
  - `endpoint` string, nullable
  - `deployment` string, nullable
  - `client_rtc_contracts` string[], nullable
  - `client_features` string[], nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dreamscalelabs/apis/dreamscale-control-plane.md) - [All operations](https://skmtc.dev/dreamscalelabs/apis/dreamscale-control-plane/llms.txt) - [OpenAPI document](https://skmtc.dev/dreamscalelabs/apis/dreamscale-control-plane/revisions/ced796c07cb0?raw)