List Plants

GET

/api/creative/plot/plants

• DivinityEngine - Local development
• DivinityEngine - Localhost alternative

List plants, optionally filtered by status, type, or plotline.

Parameters

Query Parameters

status

Any of:

string

string

null

null

plant_type

Any of:

string

string

null

null

plotline_id

Any of:

string

string

null

null

Responses

200

Successful Response

PlantListResponse

Plant list response.

object

status

required

Status

Operation status

string

data

required

PlantListData

List payload

object

plants

required

Plants

Plants

Array<object>

PlotPlant

A narrative plant (Chekhov’s gun) tracked for payoff.

object

id

required

Id

Plant UUID

string

projectId

required

Projectid

Owning project

string

title

required

Title

Plant title

string

description

Description

What is being planted

string

""

plantType

Planttype

Plant classification

string

default: establishing

Allowed values: establishing reveal soft

plantStatus

Plantstatus

Lifecycle status

string

default: planted

Allowed values: planted tapped paid_off orphaned red_herring

plantedAtNodeId

Any of:

string

string

null

null

payoffAtNodeId

Any of:

string

string

null

null

plotlineId

Any of:

string

string

null

null

lastTappedAtNodeId

Any of:

string

string

null

null

visibility

Visibility

How obvious the plant is

string

default: medium

Allowed values: hidden subtle medium obvious

notes

Notes

Author notes

string

""

plantedAtNodeTitle

Plantedatnodetitle

Plant node title (denormalized)

string

""

payoffAtNodeTitle

Payoffatnodetitle

Payoff node title (denormalized)

string

""

lastTappedAtNodeTitle

Lasttappedatnodetitle

Last tap node title (denormalized)

string

""

plotlineTitle

Plotlinetitle

Plotline title (denormalized)

string

""

createdAt

required

Createdat

Created timestamp (ms)

integer

modifiedAt

required

Modifiedat

Modified timestamp (ms)

integer

total

required

Total

Total count

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