Checks
Set or clear a maintenance window
Sets maintenance_until on the check. While a maintenance window is active (now < maintenance_until) it holds:
- every deadline incident: a missed or never-started run, an overrun, a stall, and a blocked run outliving blocked_timeout_s;
- on an HTTP monitor, failing probes: they are recorded but open no incident, and if the site is still failing when the window ends, the next failure opens one. On an HTTP monitor any fail is treated as a probe's, including one sent to its ping URL by hand.
Everything the job reports itself still notifies during the window: its own fail ping (a job that says it failed is news either way), the page a blocked ping queues, a runaway ping rate, and any routed note, started, success or every-run event.
Exactly one of duration, until, or clear must be provided:
- duration — a Go duration string (e.g. "1h", "24h", "72h").
- until — an RFC 3339 timestamp for a custom end time.
- clear — set to true to remove the maintenance window immediately.
post/api/v1/checks/{id}/snooze
Request
- Base URL: https://app.lastping.dev
- URL: https://app.lastping.dev/api/v1/checks/{id}/snooze
- Auth: API key in header X-Api-Key
Request body
Example request
{
"duration": "1h",
"until": "2026-07-17T00:00:00Z"
}Response
Check with maintenance_until updated.
Example response
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Daily backup job",
"slug": "daily-backup",
"schedule_kind": "simple",
"period_s": 86400,
"cron_expr": "0 3 * * *",
"tz": "UTC",
"grace_s": 600,
"max_runtime_s": 14400,
"step_timeout_s": 300,
"expect_every_s": 900,
"notify_min_run_s": 300,
"blocked_timeout_s": 86400,
"failure_threshold": 3,
"monitor_from": "2026-01-01T00:00:00Z",
"status": "up",
"last_ping_at": "2026-07-10T03:00:05Z",
"due_at": "2026-07-11T03:00:00Z",
"alert_after": "2026-07-11T03:10:00Z",
"maintenance_until": "2026-07-11T09:00:00Z",
"created_at": "2026-07-01T12:00:00Z",
"ping_url": "https://ingest.lastping.dev/550e8400-e29b-41d4-a716-446655440000",
"monitor_type": "http",
"probe_url": "https://example.com/healthz",
"probe_method": "GET",
"probe_expected_body": "\"status\":\"ok\"",
"probe_interval_s": 60,
"probe_expected_status": 200,
"probe_timeout_s": 10,
"next_probe_at": "2026-07-13T03:01:00Z",
"ci_provider": "github",
"ci_configured": true,
"ci_webhook_url": "https://ingest.lastping.dev/ci/github/550e8400-e29b-41d4-a716-446655440000",
"ci_secret": "a3f8c2d1e4b7a9f0c3d2e1b4a7f8c0d3e2b1a4f7",
"ci_workflow": "ci.yml",
"ci_branch": "main",
"ci_ignored": {
"count": 12,
"last_at": "2026-10-08T14:02:11Z",
"last_workflow": "CI",
"last_branch": "feature/login",
"last_matched_at": "2026-10-01T09:00:00Z",
"filters_changed_at": "2026-09-20T12:00:00Z",
"same_workflow_count": 3,
"same_workflow_last_at": "2026-10-08T11:40:00Z",
"same_workflow_last_branch": "release/2.4",
"new_workflow": "Deploy prod",
"new_workflow_first_at": "2026-10-06T09:12:00Z",
"new_workflow_count": 2
},
"runaway_ceiling": 20,
"tags": [
"agent:claude",
"env:prod"
],
"agent_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"source_kind": "github-actions",
"source_ref": ".github/workflows/nightly.yml#build",
"trace_content": "dropped",
"kind": "cron",
"uptime_90d": 99.67,
"latency_ms": 142,
"routes_count": 2,
"recent_outcomes": [
"succeeded",
"succeeded",
"failed"
],
"hook_version": 2,
"hook_version_current": 2
}Changes
No recorded changes to this operation across all 2 revisions of this API.