Skip to content
Ishvana Ishvana Docs

Get Plotline

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

Get a plotline with its points and entities.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
plotline_id
required
Plotline Id
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

PlotlineDetailResponse

Detail response wrapper.

object
status
required
Status

Operation status

string
data
required
PlotlineDetailData

Detail payload

object
plotline
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
points
required
Points

Plot points

Array<object>
PlotPoint

A single plot point (beat) within a plotline.

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
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
wordCountTarget
Any of:
integer
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
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
sourceNodeType
Any of:
string
Allowed values: series book part act chapter scene beat
createdAt
required
Createdat

Created timestamp (ms)

integer
modifiedAt
required
Modifiedat

Modified timestamp (ms)

integer
entities
required
Entities

Tagged entities

Array<object>
PlotlineEntity

Entity tagged to a plotline or plot point.

object
id
required
Id

Link UUID

string
loreEntryId
required
Loreentryid

Lore entry

string
role
Role

Role in plotline

string
""
title
Title

Entity title (denormalized)

string
""
inheritedFrom
Any of:
string
categoryId
Any of:
string
ancestorEntityIds
Ancestorentityids

Lore entry IDs tagged at ancestor plotlines (for search suggestions)

Array<string>
default:

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