Skip to content

List Events

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

Get all events for a timeline with optional filters.

timeline_id
required
Timeline Id
string
category
Any of:
string
importance
Any of:
string
lane_id
Any of:
string

Successful Response

EventListResponse

List of events.

object
status
required
Status

Operation status

string
data
required
Data

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

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