---
title: "Create Session"
method: POST
path: "/v1/workflow/playground/sessions"
tags: ["workflow-playground"]
---

# Create Session

`POST /v1/workflow/playground/sessions`

## Request body

- CreatePlaygroundSessionRequest — Open a session against a catalog workflow (``catalog_slug``) or a DB revision (``revision_id``). Exactly one source must be supplied.
  - `catalog_slug` string, nullable
  - `revision_id` string, uuid, nullable

## Response `201`

Successful Response

- PlaygroundSessionResponse — Session metadata returned by ``POST /sessions`` and ``GET /sessions/{id}``. Exactly one of ``catalog_slug`` / ``revision_id`` is set, reflecting which source the session was opened against.
  - `session_id` string, required
  - `catalog_slug` string, nullable
  - `revision_id` string, uuid, nullable
  - `graph` SrcWorkflowPlaygroundSchemasGraphMeta, required — The small graph descriptor surfaced to a client on session start / GET.
    - `name` string, required
    - `entry_node_id` string, required
    - `persona` string, nullable
  - `current_step_id` string, nullable, required
  - `completed_steps` string[], required
  - `context_vars` object, required
  - `step_count` integer, required
  - `last_signal` string, nullable, required
  - `awaiting_approval` boolean
  - `created_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.net/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneloop-hq/feather-api/versions/888bdd5c076e/schema)