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

# Create Internal Session

`POST /internal/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/internal/v1/sessions`
- Auth: none declared

## Request body

- InternalCreateSessionBody
  - `user_id` string, required
  - `user_email` string, nullable
  - `model` string, required
  - `preferred_region` string, nullable
  - `region_pin` boolean
  - `region_order` string[], nullable
  - `region_order_source` 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

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