Client area

GET · Logs & monitoring

List, create, delete a website monitor, or read one monitor's up/down events

List, create, delete a website monitor, or read one monitor's up/down events

GET /api/v1/monitors
R Read
Scope read:hosting

Description

action=list returns every monitor (data[] + deprecated); create needs a domain (and optional frequency/notifyOnOnline); delete and events need a monitorId. Monitoring is deprecated toward inleed.io. create/delete require write:hosting.

Query parameters

Name Type Description
action required enum list all monitors, create one (needs domain), delete one (needs monitorId), or read one monitor's up/down events (needs monitorId). create/delete require write:hosting. One of list, create, delete, events.

Responses

The specification does not describe this response body; the note in the rail says what to expect. Every non-2xx response is an RFC 7807 problem with a stable code.

Commonly returned errors

The codes this operation reaches on its own path: the auth stack, its own validation and ownership checks, and the transport. Not a closed set — a shared code from the full registry can still surface. Each links to the code’s own page, the same URL its type dereferences to.

401 No token was presented, or the token is revoked, expired or unknown.
403 The token lacks a required scope, or this account does not own the resource.
422 Validation error
429 The rate limit for this token is exhausted. See `Retry-After`.
500 Something went wrong on our side. The failure is logged against `requestId`.
Esc
navigate open Esc close