For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
GuidesAPI Reference
GuidesAPI Reference
  • Overview
    • API reference
  • Search
    • POSTSearch
    • GETSearch Run List
    • GETSearch Run Get
    • GETSearch Run Events
    • POSTSearch Run Cancel
  • Extract
    • GETExtract a URL
    • POSTExtract
  • Monitors
    • GETList monitors
    • POSTCreate monitor
    • GETRetrieve monitor
    • DELDelete monitor
    • PATCHUpdate monitor
    • GETList monitor events
    • POSTMonitor Pause
    • POSTMonitor Resume
    • POSTRun monitor
  • Tasks
    • POSTTask
    • POSTCreate task run
    • GETRetrieve task run
    • GETStream task run events
    • GETTask List
    • GETTask Get
    • GETTask Events
    • POSTTask Cancel
  • Chat
    • POSTChat completion
  • Find All
    • POSTFindAll
    • GETFindall Run List
    • POSTCreate FindAll run
    • GETRetrieve FindAll run
    • GETStream FindAll run events
    • POSTCancel FindAll run
    • POSTExtend FindAll run
    • POSTEnrich FindAll run
LogoLogo
Monitors

Monitor Resume

||View as Markdown|
POST
https://core.usescout.sh/v1/monitors/:monitor_id/resume
POST
/v1/monitors/:monitor_id/resume
$curl -X POST https://core.usescout.sh/v1/monitors/monitor_id/resume \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{}'
1{
2  "id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
3  "query": "latest cybersecurity threats",
4  "cadence": "daily",
5  "country": "US",
6  "language": "en",
7  "status": "active",
8  "metadata": {
9    "team": "security",
10    "priority": "high"
11  },
12  "createdAt": "2024-05-20T08:00:00Z",
13  "runs": 42,
14  "cron": "0 6 * * *",
15  "mode": "diff",
16  "filter_prompt": "Only include critical vulnerabilities",
17  "notify_on": [
18    "change",
19    "error"
20  ],
21  "webhook_max_attempts": 3,
22  "webhook_backoff_seconds": 30,
23  "webhook_secret_set": true,
24  "webhook": "https://hooks.example.com/monitor-updates",
25  "lastRunAt": "2024-06-01T06:00:00Z",
26  "nextRunAt": "2024-06-02T06:00:00Z",
27  "last_webhook_status": 200,
28  "last_webhook_at": 1685606400,
29  "last_webhook_error": null,
30  "last_result": {
31    "event_id": "evt-9876543210",
32    "results_count": 15,
33    "ran_at": "2024-06-01T06:00:00Z",
34    "status": "success"
35  }
36}

Resume a paused monitor: recomputes next_run_at from cron/cadence.

Was this page helpful?
Previous

Monitor Pause

Next

Run monitor

Built with

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