Skip to main content
GET
List events

Authorizations

Authorization
string
header
required

An API key from Settings, API Keys. A caller on this machine needs none.

Query Parameters

enabled
boolean | null

Only enabled, or only disabled, events

Response

All events, earliest first

id
string
required
Pattern: ^[a-fA-F0-9]{24}$
Example:

"68b1f0c2a4d3e5f6a7b8c9d0"

name
string
required
description
string
default:""
required
color
string
default:""
required
enabled
boolean
default:true
required
starts_at
string
required

ISO 8601, read in the server's own zone. The only place the event's time-of-day lives

days
enum<string>[]
required

Weekdays it may fall on, narrowing the cadence. Weekdays-only is ["mo","tu","we","th","fr"]

Available options:
mo,
tu,
we,
th,
fr,
sa,
su
action
object
required
Example:
targets
object
required
last_commands
string[]
required

The commands the last fire created

history
object[]
required
created_at
number
required
updated_at
number
required
ends_at
string | null

When the window closes, or null for a moment rather than a window. The event reverses itself there. A suspend resumes, a spawner stop starts. So an action with no reverse cannot have one. A time-of-day at or before starts_at crosses midnight. Not until: this is when tonight's window shuts.

every
string | null

How often it repeats: 15m, 1h, 1d, 2w, 1 month. Null fires once. With no starts_at this is dateless. The anchor is snapped to the unit, so 1h means the top of every hour.

monthday
number | null

Day of the month, or -1 for its last day. The one thing starts_at cannot say, since months differ in length

nth
number | null

Which match to keep. With days ["fr"] and a monthly cadence, -1 is the last Friday of the month

until
string | null

Stop repeating after this date. Null repeats forever. Not ends_at: this is when the event stops recurring at all.

rule
string | null

Read-only, derived: the same recurrence as an iCalendar RRULE

open_since
number | null

The occurrence whose window is open now

last_fired_at
number | null
last_occurrence
number | null
last_dispatch
enum<string> | null

Whether the last fire got its work sent. Not whether that work succeeded

Available options:
ok,
partial,
failed,
skipped,
null
last_error
string | null
last_outcome
enum<string> | null

Read-only, rolled up from those commands: what the work actually did. Null when they have aged out of the audit trail

Available options:
ok,
partial,
failed,
running,
null
next_run_at
number | null

Computed by the server. Never derive it client-side