Skip to content
Ishvana Ishvana Docs

Update Scene Participant

PUT
/api/writing/outline/nodes/participants/{participant_id}

Update a participant’s role. Returns the full refreshed list.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
participant_id
required
Participant Id
string
>= 1 characters

Request Body required

Section titled “Request Body required ”
SceneParticipantUpdateRequest

Update a participant’s role / status on a scene.

object
role
Any of:
string
Allowed values: protagonist antagonist support mentioned offstage
statusAtSceneEnd
Any of:
string
Allowed values: alive incapacitated dead

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

SceneParticipantsResponse

All participants attached to a single scene, in stable order.

object
participants
required
Participants
Array<object>
SceneParticipant

A participant linked to a scene outline node.

Wraps outline_node_entities rows where outline_nodes.node_type = 'scene'. role is the M3 participant role; source distinguishes manual entries from auto-inferred ones; status_at_scene_end (M4) is the author-editable life/death status the contradiction engine reads to detect dead-character appearances.

object
id
required
Id
string
nodeId
required
Nodeid
string
entityId
required
Entityid
string
entityName
required
Entityname
string
entityType
required
Entitytype
string
source
required
Source
string
Allowed values: manual auto
role
Any of:
string
Allowed values: protagonist antagonist support mentioned offstage
statusAtSceneEnd
Any of:
string
Allowed values: alive incapacitated dead
createdAt
required
Createdat
integer

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object