Skip to content

Bulk Update Outline Nodes

PUT
/api/writing/outline/nodes/bulk

Update multiple outline nodes at once.

Supports status / scene_type / scene_outcome / node_type (legacy) and the M3 scene-metadata fields pov_type / pov_entity_id / location_entity_id / time_marker_event_id / time_marker_text.

BulkUpdateRequest

Bulk-update fields on multiple outline nodes at once.

The M3 scene-metadata fields (location_entity_id, time_marker_event_id, time_marker_text) apply cleanly to scene nodes but are harmless on non-scene nodes when bulk-applied (service-layer writes them regardless; UI hides the columns for non-scene nodes). knowledge_state is intentionally not in the bulk payload — per-scene editing only.

object
nodeIds
required
Nodeids
Array<string>
>= 1 items
status
Any of:
string
Allowed values: draft in_progress revision done
sceneType
Any of:
string
Allowed values: scene sequel hybrid flashback vision dream
sceneOutcome
Any of:
string
Allowed values: success failure partial disaster yes_but no_and pyrrhic unexpected
nodeType
Any of:
string
Allowed values: series book part act chapter scene beat
povType
Any of:
string
Allowed values: first_person second_person third_limited third_omniscient third_objective multiple_first deep_third stream_of_consciousness unreliable
povEntityId
Any of:
string
locationEntityId
Any of:
string
timeMarkerEventId
Any of:
string
timeMarkerText
Any of:
string

Successful Response

BulkUpdateResponse

Result of a bulk update operation.

object
updated
required
Updated
integer

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