Update Plotline

PUT

/api/creative/plot/plotlines/{plotline_id}

• DivinityEngine - Local development
• DivinityEngine - Localhost alternative

Update a plotline (syncs Legendry entry).

Parameters

Path Parameters

plotline_id

required

Plotline Id

string

Request Body ^required

PlotlineUpdateRequest

Update an existing plotline.

object

title

Any of:

string

string

>= 1 characters <= 500 characters

null

null

summary

Any of:

string

string

null

null

subplotType

Any of:

string

string

Allowed values: main mirror contrast complication character_development world_building

null

null

scale

Any of:

string

string

Allowed values: saga arc plotline subplot

null

null

color

Any of:

string

string

null

null

status

Any of:

string

string

Allowed values: active resolved dormant dropped

null

null

importance

Any of:

string

string

Allowed values: major supporting minor

null

null

beatSheetTemplateId

Any of:

string

string

null

null

stakes

Any of:

string

string

null

null

themes

Any of:

string

string

null

null

notes

Any of:

string

string

null

null

categoryId

Any of:

string

string

null

null

Responses

200

Successful Response

PlotlineResponse

Single plotline response wrapper.

object

status

required

Status

Operation status

string

data

required

Plotline

The plotline

object

id

required

Id

Plotline UUID

string

projectId

required

Projectid

Owning project

string

parentId

Any of:

string

string

null

null

title

required

Title

Plotline title

string

summary

Summary

Brief summary

string

""

subplotType

Subplottype

Subplot classification

string

default: main

Allowed values: main mirror contrast complication character_development world_building

scale

Scale

Narrative scope (saga/arc/plotline/subplot)

string

default: plotline

Allowed values: saga arc plotline subplot

color

Color

Display color hex

string

default: #6b7280

sortOrder

Sortorder

Sort position among siblings

integer

0

status

Status

Lifecycle status

string

default: active

Allowed values: active resolved dormant dropped

importance

Importance

Importance tier

string

default: major

Allowed values: major supporting minor

beatSheetTemplateId

Any of:

string

string

null

null

loreEntryId

Any of:

string

string

null

null

stakes

Stakes

What’s at risk if this plotline fails

string

""

themes

Themes

Recurring themes, symbols, or motifs

string

""

notes

Notes

Private author notes

string

""

createdAt

required

Createdat

Created timestamp (ms)

integer

modifiedAt

required

Modifiedat

Modified timestamp (ms)

integer

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