create_slo

POST

/slos

curl --request POST \
  --url https://api.siteqwality.com/slos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "settings": { "name": "example", "enabled": true, "service_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "tags": [ "example" ], "severity": "example", "urgency_override": "example", "routing": { "firing": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "resolved": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "warning": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "no_data": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "error": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ] }, "runbook_url": "example", "notification_timing": { "renotify_seconds": 1, "cooldown_seconds": 1 } }, "sli": { "monitor_type": "example", "monitor_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "type": "uptime" }, "target": 1, "period_days": 1, "burn_windows": [ { "long_seconds": 1, "short_seconds": 1, "burn_rate": 1, "severity": "example" } ], "late_data_seconds": 1 }'

• Production

Authorizations

• bearer_auth

Request Body ^required

Media type application/json

object

settings

required

object

name

required

string

enabled

boolean

service_id

string | null format: uuid

tags

Array<string>

severity

required

string

urgency_override

string | null

routing

object

firing

Array<string>

resolved

Not used: a resolve goes to every channel told the episode fired.

Array<string>

warning

Array<string>

no_data

Array<string>

error

Array<string>

runbook_url

string | null

notification_timing

object

renotify_seconds

Zero disables reminders. Timers use evaluated input time, never retries.

integer format: int32

cooldown_seconds

integer format: int32

sli

required

One of:

object

Observed monitor health seconds, excluding maintenance and unobserved minutes.

object

monitor_type

required

string

monitor_id

required

string format: uuid

type

required

string

Allowed values: uptime

object

object

good

required

One of:

object

object

query

required

A log, span or trace query: the explorer URL, a saved view, a widget, an alert rule and an MCP call all carry this. text and filters are AND-combined.

object

v

required

integer format: int32

signal

required

The signal of an [EventQuery].

string

Allowed values: logs spans traces

text

The text grammar (6.5.2).

string

filters

The f grammar (6.5.1), parsed for the signal’s scope.

Array<string>

range

required

A window of T2 tokens (now, now-2h) or instants (ISO 8601, epoch milliseconds), resolved when the query is compiled, so a stored view stays rolling.

object

from

required

string

to

required

string

tz

string | null

analytics

One of:

object

Group-by analytics over an [EventQuery]: a time series or a top list.

object

group_by

Up to three fields, in the f field syntax (service, @http.route).

Array<string>

measure

object

op

required

string

Allowed values: count sum avg min max p50 p75 p90 p95 p99

field

A numeric field (duration, @db.rows); none for count.

string | null

interval

A T2 bucket interval or auto; absent means auto.

string | null

limit

Groups returned, 1 to 100; absent means 10.

integer | null format: int32

display

string

Allowed values: timeseries toplist

null

null

type

required

string

Allowed values: event

object

object

query

required

A metrics query: lettered queries, formulas over them, one window.

object

v

required

integer format: int32

queries

required

Array<object>

object

id

required

string

metric

required

string

filters

The f grammar in metrics scope.

Array<string>

time_agg

One of:

string

Absent: the default for the metric’s type (histograms: merge, merge).

string

Allowed values: merge avg min max sum count last rate increase p50 p75 p90 p95 p99

null

null

space_agg

One of:

string

string

Allowed values: merge avg sum min max count p50 p75 p90 p95 p99

null

null

group_by

Array<string>

limit

Top N series, at most 500.

integer | null format: int32

formulas

Array<object>

object

id

required

string

expr

required

string

alias

string | null

unit

One of:

string

string

Allowed values: ms seconds percent count bytes score per_second none

null

null

hidden

boolean

range

required

A window of T2 tokens (now, now-2h) or instants (ISO 8601, epoch milliseconds), resolved when the query is compiled, so a stored view stays rolling.

object

from

required

string

to

required

string

interval

A T2 bucket interval or auto.

string | null

compare

Overlay the same query this long ago, as 1w.

string | null

show

Query and formula ids to draw; empty draws the formulas, or every query when none.

Array<string>

output

required

string

type

required

string

Allowed values: metric

total

required

One of:

object

object

query

required

A log, span or trace query: the explorer URL, a saved view, a widget, an alert rule and an MCP call all carry this. text and filters are AND-combined.

object

v

required

integer format: int32

signal

required

The signal of an [EventQuery].

string

Allowed values: logs spans traces

text

The text grammar (6.5.2).

string

filters

The f grammar (6.5.1), parsed for the signal’s scope.

Array<string>

range

required

A window of T2 tokens (now, now-2h) or instants (ISO 8601, epoch milliseconds), resolved when the query is compiled, so a stored view stays rolling.

object

from

required

string

to

required

string

tz

string | null

analytics

One of:

object

Group-by analytics over an [EventQuery]: a time series or a top list.

object

group_by

Up to three fields, in the f field syntax (service, @http.route).

Array<string>

measure

object

op

required

string

Allowed values: count sum avg min max p50 p75 p90 p95 p99

field

A numeric field (duration, @db.rows); none for count.

string | null

interval

A T2 bucket interval or auto; absent means auto.

string | null

limit

Groups returned, 1 to 100; absent means 10.

integer | null format: int32

display

string

Allowed values: timeseries toplist

null

null

type

required

string

Allowed values: event

object

object

query

required

A metrics query: lettered queries, formulas over them, one window.

object

v

required

integer format: int32

queries

required

Array<object>

object

id

required

string

metric

required

string

filters

The f grammar in metrics scope.

Array<string>

time_agg

One of:

string

Absent: the default for the metric’s type (histograms: merge, merge).

string

Allowed values: merge avg min max sum count last rate increase p50 p75 p90 p95 p99

null

null

space_agg

One of:

string

string

Allowed values: merge avg sum min max count p50 p75 p90 p95 p99

null

null

group_by

Array<string>

limit

Top N series, at most 500.

integer | null format: int32

formulas

Array<object>

object

id

required

string

expr

required

string

alias

string | null

unit

One of:

string

string

Allowed values: ms seconds percent count bytes score per_second none

null

null

hidden

boolean

range

required

A window of T2 tokens (now, now-2h) or instants (ISO 8601, epoch milliseconds), resolved when the query is compiled, so a stored view stays rolling.

object

from

required

string

to

required

string

interval

A T2 bucket interval or auto.

string | null

compare

Overlay the same query this long ago, as 1w.

string | null

show

Query and formula ids to draw; empty draws the formulas, or every query when none.

Array<string>

output

required

string

type

required

string

Allowed values: metric

unit

required

string

type

required

string

Allowed values: ratio

object

object

query

required

A metrics query: lettered queries, formulas over them, one window.

object

v

required

integer format: int32

queries

required

Array<object>

object

id

required

string

metric

required

string

filters

The f grammar in metrics scope.

Array<string>

time_agg

One of:

string

Absent: the default for the metric’s type (histograms: merge, merge).

string

Allowed values: merge avg min max sum count last rate increase p50 p75 p90 p95 p99

null

null

space_agg

One of:

string

string

Allowed values: merge avg sum min max count p50 p75 p90 p95 p99

null

null

group_by

Array<string>

limit

Top N series, at most 500.

integer | null format: int32

formulas

Array<object>

object

id

required

string

expr

required

string

alias

string | null

unit

One of:

string

string

Allowed values: ms seconds percent count bytes score per_second none

null

null

hidden

boolean

range

required

A window of T2 tokens (now, now-2h) or instants (ISO 8601, epoch milliseconds), resolved when the query is compiled, so a stored view stays rolling.

object

from

required

string

to

required

string

interval

A T2 bucket interval or auto.

string | null

compare

Overlay the same query this long ago, as 1w.

string | null

show

Query and formula ids to draw; empty draws the formulas, or every query when none.

Array<string>

output

required

string

threshold

required

number format: double

unit

required

string

type

required

string

Allowed values: distribution

target

required

number format: double

period_days

required

integer format: int32

burn_windows

Array<object>

object

long_seconds

required

integer format: int32

short_seconds

required

integer format: int32

burn_rate

required

number format: double

severity

required

string

late_data_seconds

required

integer format: int32

Responses

201

Created

Media type text/plain

string format: uuid