Skip to main content
POST
A standing refresh — cadence + per-run cap + webhook diff

Authorizations

Authorization
string
header
required

fn_live_… or fn_test_… — Authorization: Bearer

Headers

fn-version
string

Dated API version; defaults to the account pin. Honesty note: with one version in existence the gateway echoes any value back as effective WITHOUT validating it — validation against the known-versions set is planned, so send only real dated versions from https://docs.fiveninelabs.com/changelog

Example:

"2026-08-26"

Idempotency-Key
string

24h replay window; a retry never bills twice

Maximum string length: 255

Body

application/json
watch
object
required

exactly one of

cadence_s
integer
required
Required range: x >= 3600
max_spend_usd_per_run
number
required
name
string
webhook_url
string<uri>
notify
string

change-only (default) | every-run

Response

Monitor created; first run fires now

id
string
required
Example:

"mon_5wp0d"

object
string
required
Allowed value: "monitor"
status
string
required

active | paused | failing (open enum); pauses itself after 3 consecutive failures

name
string
watch
object
cadence_s
integer
max_spend_usd_per_run
number
worst_case_monthly_usd
number

stated before you create

last_run
object
next_run_at
string<date-time>
lifetime_spend_usd
number