---
title: "Create run session"
method: POST
path: "/api/v3/workspaces/{workspace}/run-sessions/"
---

# Create run session

`POST /api/v3/workspaces/{workspace}/run-sessions/`

Create and start a new run session for an SLX.

## Path parameters

- `workspace` string, required

## Request body

- RunSessionCreateRequest
  - `slxName` string — SLX to run
  - `location` string — Runner location
  - `envVars` object

## Response `201`

Run session created

- RunSession
  - `id` string — Run session ID
  - `slxName` string
  - `status` 'RUNNING' | 'SUCCEEDED' | 'FAILED'
  - `createdAt` string, date-time
  - `completedAt` string, date-time, nullable

---

[API](https://skmtc.dev/runwhen/apis/runwhen-platform-api.md) · [All operations](https://skmtc.dev/runwhen/apis/runwhen-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runwhen/runwhen-platform-api/revisions/9d1a64d4b1c1/schema)