List monitors
Changed onList your monitors with optional search and filters.
Request
- Base URL: https://api.context.dev/v1
- URL: https://api.context.dev/v1/monitors
- Auth: HTTP bearer
Query parameters
Free-text search term, matched against the fields named in search_by.
Fields to search with q. Defaults to all fields; page and extract targets can have instructions.
prefix for as-you-type prefix matching (default), exact for full-token matching.
Filter monitors by lifecycle status.
Filter by target type.
Filter by change detection type.
Comma-separated list of tags to filter by (matches monitors having any of them).
Filter to items that have this tag.
Maximum number of items to return per page (1-100). Defaults to 25.
Opaque pagination cursor from a previous response.
Response
A paginated list of monitors
Example response
{
"data": [
{
"id": "mon_123",
"name": "Acme pricing monitor",
"target": {
"url": "https://acme.com/pricing",
"instructions": "Report pricing or plan availability changes. Ignore counters, timestamps, testimonials, and navigation.",
"include_selectors": [
"#attraction-details"
],
"exclude_selectors": [
".carousel",
"[id^=\"TA_\"]"
]
},
"schedule": {
"frequency": 6,
"unit": "hours"
},
"webhook": {
"url": "https://example.com/webhook",
"events": [
"change.detected",
"run.completed"
],
"retry": {
"delays_seconds": [
10,
60,
300,
1800,
7200,
21600,
57600
]
},
"secret": "whsec_8f3a…"
},
"last_error": {
"code": "fetch_failed",
"message": "The target URL could not be fetched."
},
"webhook_failure": {
"consecutive_failures": 3,
"last_message": "Webhook endpoint returned HTTP 429."
},
"tags": [
"pricing",
"competitor"
],
"baseline": {
"text": "Acme Pricing\nStarter $9/mo…"
}
}
],
"request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91"
}Changes
- warning
added the new
NO_PUBLISHED_MARKDOWNenum value to theresponse property for the response status - warning
added the new
NO_PUBLISHED_MARKDOWNenum value to theresponse property for the response status - warning
added the new
NO_PUBLISHED_MARKDOWNenum value to theresponse property for the response status - warning
added the new
NO_PUBLISHED_MARKDOWNenum value to theresponse property for the response status
- warning
- 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
- info