Skip to content
Ishvana Ishvana Docs

Generate Plotline From Outline

POST
/api/creative/plot/plotlines/from-outline

Generate a plotline with beats from an outline subtree.

Request Body required

Section titled “Request Body required ”
GeneratePlotlineFromOutlineRequest

Request to generate a plotline from an outline node’s subtree.

object
parentNodeId
required
Parentnodeid

Outline node whose subtree becomes beats

string
title
required
Title

Title for the new plotline

string
targetNodeType
required
Targetnodetype

Which level of the subtree becomes beats

string
Allowed values: series book part act chapter scene beat
subplotType
Subplottype

Subplot classification

string
default: main
Allowed values: main mirror contrast complication character_development world_building
scale
Scale

Narrative scope

string
default: plotline
Allowed values: saga arc plotline subplot
parentPlotlineId
Any of:
string

Responses

Section titled “ Responses ”

200

Section titled “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
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
loreEntryId
Any of:
string
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

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