Monitors / Pause

Pause or resume one monitor. Set paused to true to pause checks, or false to resume. Resuming requires available monitor capacity.

Endpoint

Method POST
Url https://downdar.com/api/v1/monitors/pause

Request

Key fields

guid key Monitor id.
monitor_type key http, ping, tcp, ssl, or dns.
paused key true to pause, false to resume.
{ "guid": "550e8400-e29b-41d4-a716-446655440000", "monitor_type": "http", "paused": true }

Response

Top level

ok Always true on success.
monitor Pause result. Fields below apply to monitor.
capacity Monitor quota for the account.
rate_limit Rate limit state for the tier this endpoint consumes. Present on every successful response.

monitor

guid Monitor id.
monitor_type http, ping, tcp, ssl, or dns.
paused Echoes the requested pause state.

capacity

limit Maximum monitors allowed on your plan.
used Monitors currently in use.
remaining Monitors you can still create.

rate_limit

tier Rate tier this endpoint counts against (1-5).
cost Units consumed by this request against the tier window.
timeframe Rolling limit window: second, minute, hour, or day.
limit Maximum units allowed in the timeframe for this tier on your plan.
used Units already used in the current window.
remaining Units left before this tier returns HTTP 429.
{ "ok": true, "monitor": { "guid": "550e8400-e29b-41d4-a716-446655440000", "monitor_type": "http", "paused": true }, "capacity": { "limit": 10, "used": 2, "remaining": 8 }, "rate_limit": { "tier": 1, "cost": 1, "timeframe": "minute", "limit": 60, "used": 12, "remaining": 48 } }