Monitors

Update a website-change monitor

Partially updates one of the caller's own monitors. Free to call. Changing target_type or sitemap resets the stored diff baseline (fingerprint, snapshot, or URL set), so the next check establishes a fresh baseline instead of comparing against a now-meaningless prior state.

patch/monitors/{id}

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/monitors/{id}
  • Auth: API key in header x-api-key

Path parameters

idstring required

Monitor ID returned by your account monitor create/list response; replace the illustrative example with your own ID

Headers

Authorizationstring

Dashboard JWT in the form Token <jwt> (use this or x-api-key)

x-api-keystring

API key (alternative to a dashboard JWT)

Request body

cadence_minutesinteger
enabledboolean
namestring
target_type'page' | 'sitemap'

Example request

{
  "cadence_minutes": 60,
  "enabled": true,
  "name": "Pricing page",
  "notification": {
    "events": [
      "change.detected",
      "run.completed"
    ],
    "webhook_secret": "whsec_...",
    "webhook_url": "https://example.com/webhooks/crawlora"
  },
  "sitemap": {
    "exclude_patterns": [
      "/blog/*"
    ],
    "include_patterns": [
      "/products/*"
    ],
    "max_urls": 5000
  },
  "target_type": "page"
}

Response

Updated monitor

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "cadence_minutes": 60,
    "created_at": "2026-08-01T00:00:00Z",
    "enabled": true,
    "id": "66d2f0b1c2a4e5f6a7b8c9d0",
    "last_changed_at": "2026-08-20T09:00:00Z",
    "last_checked_at": "2026-08-22T10:00:00Z",
    "name": "Pricing page",
    "next_check_at": "2026-08-22T11:00:00Z",
    "notification": {
      "events": [
        "change.detected",
        "run.completed"
      ],
      "webhook_url": "https://example.com/webhooks/crawlora"
    },
    "sitemap": {
      "exclude_patterns": [
        "/blog/*"
      ],
      "include_patterns": [
        "/products/*"
      ],
      "max_urls": 5000
    },
    "target_type": "page",
    "updated_at": "2026-08-22T10:00:00Z",
    "url": "https://example.com/pricing"
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.