Monitors

Retrieve a monitor change

Changed on

Retrieve a detected change, including its diff and available evidence.

get/monitors/changes/{change_id}

Request

  • Base URL: https://api.context.dev/v1
  • URL: https://api.context.dev/v1/monitors/changes/{change_id}
  • Auth: HTTP bearer

Path parameters

change_idstring required

ID of the detected change.

Example:chg_123

Response

Change details

mode'web' required

Always web. Optional.

idstring required
monitor_idstring required
run_idstring required

The run that detected this change.

target_type'page' | 'sitemap' | 'extract' required
change_detection_type'exact' | 'semantic' required
titlestring required
summarystring required
detected_atstring date-time required
urlstring uri required
importance'low' | 'medium' | 'high'
confidencenumber
diffstring

Text diff between the previous and current page baseline (page targets).

before_text_excerptstring
after_text_excerptstring
added_urlsstring[]

At most 500 URLs are included; the corresponding count field is always exact.

removed_urlsstring[]

At most 500 URLs are included; the corresponding count field is always exact.

added_url_countinteger
removed_url_countinteger
matched_urlsstring[]

At most 500 URLs are included; the corresponding count field is always exact.

matched_url_countinteger
tagsstring[] required

Labels for filtering monitors, their changes, and their usage.

request_idstring uuid required

Unique ID of this request, also in X-Request-Id. Include it when contacting support.

Example response

{
  "id": "chg_123",
  "monitor_id": "mon_123",
  "run_id": "run_123",
  "title": "Acme pricing page changed",
  "summary": "The visible text on the page changed.",
  "tags": [
    "pricing",
    "competitor"
  ],
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91"
}

Changes

  • 61627728926bRevision changes
    • warning

      added the new NO_PUBLISHED_MARKDOWN enum value to the response property for the response status

    • warning

      added the new NO_PUBLISHED_MARKDOWN enum value to the response property for the response status

    • warning

      added the new NO_PUBLISHED_MARKDOWN enum value to the response property for the response status

    • warning

      added the new NO_PUBLISHED_MARKDOWN enum value to the response property for the response status

  • 4ddcf49b9fe5Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status