Create Plot Point

POST

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

• DivinityEngine - Local development
• DivinityEngine - Localhost alternative

Create a plot point within a plotline.

Parameters

Path Parameters

plotline_id

required

Plotline Id

string

Request Body ^required

PlotPointCreateRequest

Create a new plot point.

object

title

required

Title

Point title

string

>= 1 characters <= 500 characters

description

Description

Point description

string

""

pointType

Pointtype

Beat type

string

default: beat

Allowed values: beat turning_point inciting_incident climax resolution setup escalation reversal

beatSheetPositionId

Any of:

string

string

null

null

intensity

Intensity

Arc intensity 0-100

integer

default: 50 <= 100

status

Status

Drafting status

string

default: planned

Allowed values: planned drafted revised final

notes

Notes

Private author notes

string

""

documentId

Any of:

string

string

null

null

wordCountTarget

Any of:

integer

integer

null

null

povType

Any of:

string

string

Allowed values: first_person second_person third_limited third_omniscient third_objective multiple_first deep_third stream_of_consciousness unreliable

null

null

povEntityId

Any of:

string

string

null

null

sceneType

Any of:

string

string

Allowed values: scene sequel hybrid flashback vision dream

null

null

sceneOutcome

Any of:

string

string

Allowed values: success failure partial disaster yes_but no_and pyrrhic unexpected

null

null

sourceNodeType

Any of:

string

string

Allowed values: series book part act chapter scene beat

null

null

Responses

200

Successful Response

PlotPointResponse

Single plot point response wrapper.

object

status

required

Status

Operation status

string

data

required

PlotPoint

The plot point

object

id

required

Id

Plot point UUID

string

plotlineId

required

Plotlineid

Parent plotline

string

title

required

Title

Point title

string

description

Description

Point description

string

""

pointType

Pointtype

Beat type

string

default: beat

Allowed values: beat turning_point inciting_incident climax resolution setup escalation reversal

beatSheetPositionId

Any of:

string

string

null

null

intensity

Intensity

Arc intensity 0-100

integer

default: 50 <= 100

sortOrder

Sortorder

Sort position

integer

0

status

Status

Drafting status

string

default: planned

Allowed values: planned drafted revised final

notes

Notes

Private author notes

string

""

documentId

Any of:

string

string

null

null

wordCountTarget

Any of:

integer

integer

null

null

povType

Any of:

string

string

Allowed values: first_person second_person third_limited third_omniscient third_objective multiple_first deep_third stream_of_consciousness unreliable

null

null

povEntityId

Any of:

string

string

null

null

sceneType

Any of:

string

string

Allowed values: scene sequel hybrid flashback vision dream

null

null

sceneOutcome

Any of:

string

string

Allowed values: success failure partial disaster yes_but no_and pyrrhic unexpected

null

null

sourceNodeType

Any of:

string

string

Allowed values: series book part act chapter scene beat

null

null

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