Skip to main content
PATCH
Update scene

Path Parameters

session_id
string
required

Body

application/json

Body for PATCH .../sessions/{id} - partial update of mutable scene fields.

Mirrors the full SessionRepo.update _ALLOWED set: title, synopsis, project_context, npc_ids, encounter_ids, data. Each is independently optional; None means "leave unchanged" (not "set to NULL").

title/synopsis are the same human-editable fields exposed by CreateSessionRequest and the ttrpg-gm UpdateSessionRequest - they MUST be accepted here so the dashboard edit form (which submits both) does not fail validation with "Extra inputs are not permitted". title cannot be cleared (NOT NULL since migration 094); when present it must be non-empty. Limits mirror web/utils/field-limits.ts sessions.*.

title
string | null
Required string length: 1 - 200
synopsis
string | null
Maximum string length: 5000
project_context
string | null
npc_ids
string<uuid>[] | null
encounter_ids
string<uuid>[] | null
data
Data · object | null

Response

Updated scene

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