Skip to main content
PATCH
Update scene

Path Parameters

project_id
string
required
session_id
string
required

Body

application/json

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

Mirrors the SessionRepo patchable set: title, synopsis, project_context, npc_ids, encounter_ids, data. An omitted field is left unchanged; an explicit null clears synopsis / project_context and is rejected (422) on title / npc_ids / encounter_ids / data.

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.