Skip to content

Get Timeline Detail

GET
/api/creative/timelines/{timeline_id}/detail

Get full timeline detail with events, plotlines, relationships, arcs.

timeline_id
required
Timeline Id
string

Successful Response

TimelineDetailResponse

Full detail response with events, plotlines, relationships, arcs.

object
status
required
Status

Operation status

string
data
required
TimelineDetail

Full timeline detail

object
timeline
required
Timeline

Timeline metadata

object
id
Any of:
string
name
required
Name

Timeline name

string
description
Description

Description

string
""
worldId
Any of:
string
scale
TimelineScale

Time scale

string
default: years
Allowed values: years decades centuries
startDate
Startdate

Start date

string
default: 0000
endDate
Enddate

End date

string
default: 9999
calendarSystemId
Any of:
string
created
Any of:
integer
modified
Any of:
integer
tags
Tags

Tags

Array<string>
viewMode
TimelineViewMode

Active view mode

string
default: linear
Allowed values: linear swimlane overview
events
required
Events

All events

Array<object>
TimelineEvent

First-class timeline event with structured fields.

object
id
Any of:
string
timelineId
required
Timelineid

Parent timeline ID

string
title
required
Title

Event title

string
description
Description

Event description

string
""
dateDisplay
required
Datedisplay

Human-readable date string

string
dateSortKey
Datesortkey

Sortable integer date

integer
0
dateEndDisplay
Any of:
string
dateEndSortKey
Any of:
integer
era
Any of:
string
calendarSystemId
Any of:
string
category
TimelineEventCategory

Event category

string
default: cultural
Allowed values: political cultural technological war religious natural economic
importance
TimelineEventImportance

Importance level

string
default: moderate
Allowed values: minor moderate major critical
laneId
Any of:
string
sortOrder
Sortorder

Order within same date

integer
0
color
Any of:
string
tags
Tags

Tags

Array<string>
links
Links

Entity links

Array<object>
TimelineEventLink

Link from an event to an entity (character, location, document, etc.).

object
id
Any of:
string
targetId
required
Targetid

ID of the linked entity

string
targetType
required
TimelineLinkTargetType

Type of linked entity

string
Allowed values: character location document lore_entry item event
targetName
Targetname

Resolved display name

string
""
relationshipLabel
Relationshiplabel

Label describing the relationship

string
""
loreLinks
Lorelinks

Linked lore entries with link IDs

Array<object>
TimelineLoreLink

Link from an event to a lore entry, with the link record ID for unlinking.

object
id
required
Id

Link record ID

string
loreEntryId
required
Loreentryid

Lore entry ID

string
plotlineIds
Plotlineids

Plotline memberships

Array<string>
created
Any of:
integer
modified
Any of:
integer
plotlines
required
Plotlines

Plotlines / lanes

Array<object>
TimelinePlotline

Swimlane lane within a timeline.

object
id
Any of:
string
timelineId
required
Timelineid

Parent timeline ID

string
name
required
Name

Lane name

string
description
Description

Lane description

string
""
color
Color

Lane color hex

string
default: #6b7280
sortOrder
Sortorder

Display order

integer
0
entityId
Any of:
string
entityType
Any of:
string
collapsed
Collapsed

Whether lane is collapsed

boolean
relationships
required
Relationships

Event-to-event relationships

Array<object>
TimelineEventRelationship

Relationship between two events (causes, follows, etc.).

object
id
Any of:
string
sourceEventId
required
Sourceeventid

Source event ID

string
targetEventId
required
Targeteventid

Target event ID

string
relationshipType
required
TimelineEventRelationshipType

Type of relationship

string
Allowed values: causes follows simultaneous contradicts enables
description
Description

Optional description

string
""
strength
Strength

How tightly the events are coupled (0.0 = unrelated, 1.0 = direct cause)

number
default: 1 <= 1
arcPoints
required
Arcpoints

Character arc points

Array<object>
ArcPoint

Single point on a character arc curve.

object
eventId
required
Eventid

Event this arc point is anchored to

string
value
required
Value

Emotional valence 0-100

integer
<= 100
label
Label

Label for this point

string
""
notes
Notes

Author notes about why the value sits where it does

string
""
calendarSystem
Any of:
CalendarSystem

Custom fantasy calendar definition.

object
id
Any of:
string
projectId
required
Projectid

Project this calendar belongs to

string
name
required
Name

Calendar name

string
description
Description

Calendar description

string
""
eras
Eras

Era definitions

Array<object>
CalendarEra

Single era definition within a calendar system.

object
name
required
Name

Era name (e.g. ‘First Age’)

string
abbreviation
required
Abbreviation

Short form (e.g. ‘FA’)

string
startValue
Startvalue

Sort key where this era begins

integer
0
endValue
Any of:
integer
yearSpan
Any of:
integer
isCurrent
Iscurrent

Whether this is the active/ongoing era

boolean
months
Months

Month definitions

Array<object>
CalendarMonth

Single month within a calendar system.

object
name
required
Name

Month name

string
days
required
Days

Number of days in this month

integer
> 0
daysPerWeek
Daysperweek

Days per week

integer
default: 7 > 0
dayNames
Daynames

Day names in order

Array<string>
epochLabel
Epochlabel

Label for year numbering

string
default: Year
dateFormatTemplate
Dateformattemplate

Template for formatting dates

string
default: {era} {year}, {month} {day}

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