Run monitor | Scout | Documentation

curl -X POST https://core.usescout.sh/v1/monitors/monitor_id/run \
     -H "Authorization: Bearer <token>"

{
  "monitorId": "mon-1f6c2d9a4b7e",
  "event": {
    "id": "evt-7a2b9c3d1e5f",
    "monitor_id": "mon-1f6c2d9a4b7e",
    "event_group_id": "grp-4d8e2f1a",
    "summary": "2 new results for 'anthropic new model release'.",
    "event_date": "2025-01-20T09:00:00+00:00",
    "source_urls": [
      "https://www.anthropic.com/news/claude-opus",
      "https://techcrunch.com/2025/01/20/anthropic-claude"
    ],
    "results": [
      {
        "url": "https://www.anthropic.com/news/claude-opus",
        "title": "Introducing the next Claude model",
        "excerpts": [
          "The new model improves on coding and reasoning."
        ],
        "publishedDate": "2025-01-20"
      }
    ]
  }
}

Trigger a monitor run immediately (handy for testing).

Authentication

AuthorizationBearer

Your API key, sent as a Bearer token.

Path parameters

monitor_idstringRequired

Response

Successful Response

monitorIdstring

eventobject or null

The change event, or null for a baseline / no-op run.

Errors

422

Unprocessable Entity Error

$	curl -X POST https://core.usescout.sh/v1/monitors/monitor_id/run \
>	-H "Authorization: Bearer <token>"

1	{
2	"monitorId": "mon-1f6c2d9a4b7e",
3	"event": {
4	"id": "evt-7a2b9c3d1e5f",
5	"monitor_id": "mon-1f6c2d9a4b7e",
6	"event_group_id": "grp-4d8e2f1a",
7	"summary": "2 new results for 'anthropic new model release'.",
8	"event_date": "2025-01-20T09:00:00+00:00",
9	"source_urls": [
10	"https://www.anthropic.com/news/claude-opus",
11	"https://techcrunch.com/2025/01/20/anthropic-claude"
12	],
13	"results": [
14	{
15	"url": "https://www.anthropic.com/news/claude-opus",
16	"title": "Introducing the next Claude model",
17	"excerpts": [
18	"The new model improves on coding and reasoning."
19	],
20	"publishedDate": "2025-01-20"
21	}
22	]
23	}
24	}