Monitors

List monitor runs

Changed on

List a monitor’s runs, newest first.

get/monitors/{monitor_id}/runs

Request

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

Path parameters

monitor_idstring required

ID of the monitor.

Example:mon_123

Query parameters

status'queued' | 'running' | 'completed' | 'failed' | 'skipped'

Filter runs by lifecycle status.

limitinteger

Maximum number of items to return per page (1-100). Defaults to 25.

cursorstring

Opaque pagination cursor from a previous response.

Response

A paginated list of runs for the monitor

has_moreboolean required
next_cursorstring nullable required
request_idstring uuid required

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

Example response

{
  "data": [
    {
      "id": "run_123",
      "monitor_id": "mon_123",
      "change_detected": true,
      "change_id": "chg_123",
      "credits_charged": 1,
      "error": {
        "code": "fetch_failed",
        "message": "The target URL could not be fetched."
      },
      "webhook_delivery": {
        "event_id": "evt_123",
        "http_status": 200,
        "error": {
          "code": "fetch_failed",
          "message": "The target URL could not be fetched."
        }
      },
      "webhook_deliveries": [
        {
          "event_id": "evt_123",
          "http_status": 200,
          "error": {
            "code": "fetch_failed",
            "message": "The target URL could not be fetched."
          }
        }
      ]
    }
  ],
  "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