Create and check the watch
- Call list_projects and choose the project.
- Call monitor_link with its
projectId, your source and target URLs, and the target scope. Save the returned watch identifier. Identical placements are deduplicated. - Call request_link_check with the watch identifier and an idempotency value unique to this intended check.
- Save the returned job identifier. Read get_check_job until it reaches a terminal state. Respect retry guidance and avoid tight polling.
- Read get_link_history for dated observations. Use the observation identifier to locate occurrences or retrieve retained evidence.
Decide what the observation supports
A completed job can yieldunknown. Read the observation’s reason separately from the job state. One absent observation describes that fetch; confirmed loss requires two complete absent observations at least thirty minutes apart. Unknown attempts preserve uncertainty.
A source link and destination health answer different questions. To check the destination independently, use monitor_target and its check job flow.
Keep the watch active for later changes, or pause it with update_link_watch. If raw evidence has expired, keep the dated observation metadata and request a new check when needed. A new check cannot recreate the historical page. See evidence and troubleshooting.