Monitor Pause | Scout | Documentation

{
  "id": "a3f47b9e-2d4c-4f8a-9b7e-1c2d3e4f5678",
  "query": "latest cybersecurity threats",
  "cadence": "daily",
  "country": "US",
  "language": "en",
  "status": "paused",
  "metadata": {
    "createdBy": "security_team",
    "priority": "high"
  },
  "createdAt": "2024-05-10T09:15:00Z",
  "runs": 42,
  "cron": null,
  "mode": "diff",
  "filter_prompt": "Only include high severity alerts",
  "notify_on": [
    "change",
    "error"
  ],
  "webhook_max_attempts": 3,
  "webhook_backoff_seconds": 30,
  "webhook_secret_set": true,
  "webhook": "https://hooks.example.com/monitor-updates",
  "lastRunAt": "2024-06-01T08:00:00Z",
  "nextRunAt": null,
  "last_webhook_status": 200,
  "last_webhook_at": 1685606400,
  "last_webhook_error": null,
  "last_result": {
    "event_id": "evt_20240601_0800",
    "results_count": 15,
    "ran_at": "2024-06-01T08:00:00Z",
    "status": "success"
  }
}

Pause a monitor: scheduler skips it; next_run_at is cleared.

Authentication

AuthorizationBearer

Your API key, sent as a Bearer token.

Path parameters

monitor_idstringRequired

Response

Successful Response

idstring

Monitor identifier.

querystring

The tracked query.

cadencestring

hourly, daily or weekly.

countrystring

languagestring

statusstring

active or paused.

metadatamap from strings to any

Arbitrary caller metadata.

createdAtstring

ISO-8601 creation timestamp.

runsinteger

How many times the monitor has run.

cronstring or null

Cron expression (overrides cadence when present).

modestringDefaults to diff

'diff' or 'snapshot'.

filter_promptstring or null

Natural-language predicate evaluated by Claude.

notify_onlist of strings

Subset of: change | match | error.

webhook_max_attemptsintegerDefaults to 3

webhook_backoff_secondsintegerDefaults to 30

webhook_secret_setbooleanDefaults to false

True if a webhook_secret is configured (the secret itself is never returned).

webhookstring or null

Where change events are delivered, if set.

lastRunAtstring or null

ISO-8601 timestamp of the most recent run.

nextRunAtstring or null

ISO-8601 timestamp of the next run, or null when paused.

last_webhook_statusinteger or null

HTTP status of the most recent webhook delivery, or null.

last_webhook_atdouble or null

Epoch seconds the last webhook delivery completed.

last_webhook_errorstring or null

Error message from the last webhook delivery, when it failed; null on success or when no webhook is set.

last_resultobject or null

Summary of the most recent monitor event, or null.

Errors

422

Unprocessable Entity Error

$	curl -X POST https://core.usescout.sh/v1/monitors/monitor_id/pause \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'