Skip to main content
POST
Create scene

Path Parameters

project_id
string
required

Body

application/json

POST /v1/projects/{project_id}/sessions

title is required (2026-05-16, migration 094). session_number alone is not a unique identifier - there is no UNIQUE constraint on (project_id, session_number) and series_id is auto-generated per session today, so two Game Nights both numbered "1" are valid state. Without a title the dashboard list shows two indistinguishable rows.

session_number
integer
required
Required range: x >= 1
title
string
required

User-facing session name

Required string length: 1 - 200
synopsis
string | null

Short prose summary of the session

Maximum string length: 5000
project_context
string | null
Maximum string length: 50000
npc_ids
string<uuid>[]

NPCs to include

encounter_ids
string<uuid>[]

Encounters to include

Response

Scene created

The response is of type Response Create Scene V1 Projects Project Id Game Narrative Scenes Post · object.