Skip to main content
GET
Get a monitor

Authorizations

Authorization
string
header
required

Use the 'Authorization' header with the format 'Key '

Path Parameters

id
integer
required

The unique identifier of the monitor.

Response

Successful Response

The list row plus the definition, in exactly the shape create and update accept.

alert
AlertSpec · object
required

What makes a run alert.

created_at
string<date-time>
required

When the monitor was created.

enabled
boolean
required

Whether the schedule fires.

id
integer
required

Unique identifier for the monitor.

managed_in_code
boolean
required

True when the monitor's definition lives in a repo. Update and delete are refused for such a monitor — change its YAML instead.

modified_at
string<date-time>
required

When the monitor was last modified.

monitor_type
string
required

Type of the monitor.

Allowed value: "diff"
name
string | null
required

Name of the monitor.

schedule
ScheduleSpec · object
required

When the monitor runs.

datadiff
DiffConfigSpec · object | null

The diff the monitor runs. Null only for a monitor whose stored definition has gone missing, which cannot happen for one this API created.

description
string | null

Free-text description.

last_run
string<date-time> | null

When the monitor last started a run.

next_run
string<date-time> | null

When the schedule fires next.

owner
string | null

Email of the monitor owner.

slug
string | null

Stable identifier.

state
enum<string> | null

Outcome of the latest run, once it has one.

Available options:
ok,
alert,
error,
cancelled
tags
string[]

Tags on the monitor.