Monitor discovery candidate

monitor_discovery_candidate Enroll a candidate-only watch from a present verification within 24h with no newer observation. Keeps candidate/run/observation/local-reference provenance. Active-watch limits apply. Replay preserves schedules and never resumes a later paused watch; user pauses require explicit resume.

Name recorded in the 2026-10-17 deployment. This page describes current source; verify inputs and access in your connected catalog. Provider configuration and workspace access still apply.

Access	Behavior
`discovery:read`, `watches:write`	Writes or admits work

Checks and monitoring can consume workspace capacity. Queued admission is not a completed observation; inspect the returned job or saved state.

Example request

Connect through MCP, CLI, or HTTP. Replace example identifiers with records from your workspace.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "monitor_discovery_candidate",
    "arguments": {
      "jobId": "job_example",
      "idempotencyKey": "docs-request-001"
    }
  }
}

agentlinkops call monitor_discovery_candidate --args '{"jobId":"job_example","idempotencyKey":"docs-request-001"}'

curl --fail-with-body https://app.agentlinkops.com/v1/commands/monitor_discovery_candidate \
  -H "Authorization: Bearer $AGENTLINKOPS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"jobId":"job_example","idempotencyKey":"docs-request-001"}'

Returned result

Schema-validated example; IDs and dates are illustrative. MCP returns this data in structuredContent and in a text content block; generic HTTP and CLI return the JSON result directly.

Full response example

{
  "schema_version": 1,
  "workspace_id": "ws_example",
  "project_id": "pr_example",
  "verification_job_id": "job_example",
  "watch_id": "watch_example",
  "run_id": "dr_example",
  "candidate_id": "dc_bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
  "observation_id": "obs_example",
  "local_reference": "ledger:example",
  "created_at": "2026-09-13T12:00:00.000Z",
  "watch": {
    "workspace_id": "ws_example",
    "project_id": "pr_example",
    "status": "active",
    "cadence_seconds": 86400,
    "state": "present",
    "observation_state": {
      "state": "present"
    },
    "created_at": "2026-09-13T12:00:00.000Z",
    "updated_at": "2026-09-13T12:00:00.000Z",
    "last_attempt_at": "2026-09-13T12:00:00.000Z",
    "last_success_at": "2026-09-13T12:00:00.000Z",
    "last_observation_id": "obs_example",
    "next_check_at": "2026-09-13T12:00:00.000Z",
    "overdue_reason": null,
    "id": "watch_example",
    "source_url": "https://publisher.example.org/article",
    "target_url": "https://example.com/",
    "target_scope": "exact",
    "expected_anchor": null,
    "expected_rel": null,
    "local_reference": "ledger:example",
    "last_successful_observation_id": "obs_example",
    "google_crawlable": null,
    "google_crawl_reason": "not_checked",
    "robots_rule": null,
    "noindex": null,
    "page_nofollow": null,
    "link_rel": null,
    "can_verify_reason": "not_checked",
    "last_verified_at": null,
    "crawlability_provenance": {
      "robots_observed_at": null,
      "page_observed_at": null,
      "link_observed_at": null,
      "robots_observation_id": null,
      "page_observation_id": null,
      "link_observation_id": null
    }
  },
  "replayed": false,
  "recurring_monitoring_created": true
}

Input fields

Omit optional fields when you do not want to supply them. Null is accepted only where listed. Unknown input properties are rejected.

Field	Type	Presence	Meaning and constraints
`jobId`	string	Required	job ID from create/list. pattern: `"^[a-zA-Z0-9_-]{1,128}$"`
`idempotencyKey`	string	Required	Caller-generated key reused only for retries of the same operation and arguments in this workspace. pattern: `"^[\\x21-\\x7e]{1,200}$"`
`cadenceSeconds`	integer	Optional	Check interval in seconds; see bounds. minimum: `3600`; maximum: `2592000`; default: `86400`
`deal`	object	Optional	additional fields rejected
`deal.costMinor`	integer / null	Optional
`deal.currency`	string / null	Optional
`deal.acquiredOn`	string,null	Optional
`deal.expiresOn`	string,null	Optional
`deal.renewalWindowDays`	integer / null	Optional
`deal.contactRef`	string / null	Optional
`deal.contactLabel`	string / null	Optional
`deal.dealNote`	string / null	Optional
`dealRevision`	integer	Optional	minimum: `0`; maximum: `9007199254740991`

Validation and omitted values

Requires present evidence no older than 24 hours, the current observation pointer and no superseding observation. Only a newly created candidate-only watch can activate here; a user-paused existing watch requires explicit resume. Active cadence and next check remain intact. Replay preserves the original enrollment outcome and never resumes a subsequently paused watch.

Defaults when omitted

Field	Default
`cadenceSeconds`	`86400`

Output fields

Fields inside optional or nullable parents apply only when that parent exists. Common schema conventions explain evidence states, empty lists and extensions.

lifecycle (object, optional).
schema_version (number, required).
workspace_id (string, required): Workspace that owns this record.
project_id (string, required): Project that owns this record.
verification_job_id (string, required): Identifier returned by the related operation.
watch_id (string, required): Identifier returned by the related operation.
run_id (string, required): Identifier returned by the related operation.
candidate_id (string, required): Identifier returned by the related operation.
observation_id (string, required): Identifier returned by the related operation.
local_reference (string / null, required): Customer reference for joining this record to a local ledger entry.
created_at (string, required): UTC timestamp when the record was created.
watch (object, required).
replayed (boolean, required): True when the response reuses an earlier request with the same idempotency value.
recurring_monitoring_created (boolean, required): Whether this operation enrolled recurring monitoring.
enrollment_outcome (string, optional).

All fields and nested objects

Types, allowed values, limits and nested fields:

Field	Type	Presence	Meaning and constraints
`lifecycle`	object	Optional	additional fields rejected
`lifecycle.watchId`	string	Required	Identifier returned by the related operation. minLength: `1`; maxLength: `200`
`lifecycle.projectId`	string	Required	Identifier returned by the related operation. minLength: `1`; maxLength: `200`
`lifecycle.revision`	integer	Required	Recorded revision. For an update, use the revision argument named by that operation. minimum: `0`; maximum: `9007199254740991`
`lifecycle.deal`	object	Required	additional fields rejected
`lifecycle.deal.costMinor`	integer / null	Required
`lifecycle.deal.currency`	string / null	Required
`lifecycle.deal.acquiredOn`	string / null	Required
`lifecycle.deal.expiresOn`	string / null	Required
`lifecycle.deal.renewalWindowDays`	integer / null	Required
`lifecycle.deal.contactRef`	string / null	Required
`lifecycle.deal.contactLabel`	string / null	Required
`lifecycle.deal.dealNote`	string / null	Required
`lifecycle.createdAt`	string / null	Required
`lifecycle.updatedAt`	string / null	Required
`schema_version`	number	Required	must equal `1`
`workspace_id`	string	Required	Workspace that owns this record.
`project_id`	string	Required	Project that owns this record.
`verification_job_id`	string	Required	Identifier returned by the related operation.
`watch_id`	string	Required	Identifier returned by the related operation.
`run_id`	string	Required	Identifier returned by the related operation.
`candidate_id`	string	Required	Identifier returned by the related operation.
`observation_id`	string	Required	Identifier returned by the related operation.
`local_reference`	string / null	Required	Customer reference for joining this record to a local ledger entry.
`created_at`	string	Required	UTC timestamp when the record was created.
`watch`	object	Required
`watch.intent`	string	Optional	values: `"prospect"`, `"earned"`, `"retired"`
`watch.outreachStatus`	string / null	Optional
`watch.lastContactedAt`	string / null	Optional
`watch.campaign`	string / null	Optional
`watch.id`	string	Required	Resource identifier returned by the operation.
`watch.workspace_id`	string	Required	Workspace that owns this record.
`watch.project_id`	string	Required	Project that owns this record.
`watch.status`	string	Required	Resource lifecycle status. values: `"active"`, `"paused"`
`watch.cadence_seconds`	number	Required	Configured check interval in seconds. Scheduling and admission can delay completion.
`watch.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record.
`watch.observation_state`	object	Required	Saved observation state. Before the first check, this object can be empty.
`watch.observation_state.state`	string	Optional	Saved lifecycle or evidence state, as enumerated for this record.
`watch.observation_state.uncertain`	boolean	Optional	True when the latest attempt is inconclusive. Earlier conclusive state can remain recorded beside it.
`watch.observation_state.checked_at`	string	Optional	UTC timestamp of the saved check.
`watch.observation_state.lastChangedAt`	string / null	Optional
`watch.observation_state.firstAbsentAt`	string / null	Optional	UTC start of the current sequence of complete absent observations; null outside that sequence.
`watch.observation_state.nextCheckAt`	string / null	Optional	Confirmation-check eligibility requested by the state reducer; null when no extra confirmation check is requested.
`watch.observation_state.reason`	string / null	Optional	Recorded explanation; null when no explanation applies.
`watch.observation_state.latestAttempt`	object / null	Optional	Summary of the newest accepted attempt, including unknown or incomplete results; null before an attempt.
`watch.observation_state.latestAttempt.state`	string	Optional	Saved lifecycle or evidence state, as enumerated for this record.
`watch.observation_state.latestAttempt.reason`	string / null	Optional	Recorded explanation; null when no explanation applies.
`watch.observation_state.latestAttempt.checkedAt`	string	Optional	UTC timestamp of the summarized attempt.
`watch.observation_state.latestAttempt.httpStatus`	number / null	Optional
`watch.observation_state.latestAttempt.occurrenceCount`	number	Optional	Total matching occurrences reported by that attempt; its retained summary can contain fewer occurrence excerpts.
`watch.observation_state.latestAttempt.occurrences`	array	Optional
`watch.observation_state.latestAttempt.occurrences[].href`	string / null	Optional
`watch.observation_state.latestAttempt.occurrences[].targetUrl`	string / null	Optional
`watch.observation_state.latestAttempt.occurrences[].anchor`	string / null	Optional
`watch.observation_state.latestAttempt.occurrences[].rel`	array	Optional
`watch.observation_state.latestAttempt.occurrences[].context`	string / null	Optional
`watch.observation_state.latestAttempt.occurrences[].locator`	object / null	Optional
`watch.observation_state.latestAttempt.occurrences[].locator.line`	number / null	Optional
`watch.observation_state.latestAttempt.occurrences[].locator.column`	number / null	Optional
`watch.observation_state.latestAttempt.occurrences[].locator.offset`	number / null	Optional
`watch.observation_state.latestAttempt.checkerVersion`	string	Optional
`watch.observation_state.lastSuccessfulObservation`	object / null	Optional	Summary of the latest complete, conclusive observation. It survives a later unknown attempt; conclusive does not imply presence or a healthy destination.
`watch.observation_state.lastSuccessfulObservation.state`	string	Optional	Saved lifecycle or evidence state, as enumerated for this record.
`watch.observation_state.lastSuccessfulObservation.reason`	string / null	Optional	Recorded explanation; null when no explanation applies.
`watch.observation_state.lastSuccessfulObservation.checkedAt`	string	Optional	UTC timestamp of the retained conclusive observation, which can precede the latest attempt.
`watch.observation_state.lastSuccessfulObservation.httpStatus`	number / null	Optional
`watch.observation_state.lastSuccessfulObservation.occurrenceCount`	number	Optional	Total matching occurrences reported by the conclusive observation; the summary retains at most ten excerpts.
`watch.observation_state.lastSuccessfulObservation.occurrences`	array	Optional
`watch.observation_state.lastSuccessfulObservation.occurrences[].href`	string / null	Optional
`watch.observation_state.lastSuccessfulObservation.occurrences[].targetUrl`	string / null	Optional
`watch.observation_state.lastSuccessfulObservation.occurrences[].anchor`	string / null	Optional
`watch.observation_state.lastSuccessfulObservation.occurrences[].rel`	array	Optional
`watch.observation_state.lastSuccessfulObservation.occurrences[].context`	string / null	Optional
`watch.observation_state.lastSuccessfulObservation.occurrences[].locator`	object / null	Optional
`watch.observation_state.lastSuccessfulObservation.occurrences[].locator.line`	number / null	Optional
`watch.observation_state.lastSuccessfulObservation.occurrences[].locator.column`	number / null	Optional
`watch.observation_state.lastSuccessfulObservation.occurrences[].locator.offset`	number / null	Optional
`watch.observation_state.lastSuccessfulObservation.checkerVersion`	string	Optional
`watch.observation_state.lastSuccessfulObservationSameAsLatestAttempt`	boolean	Optional
`watch.observation_state.confirmedState`	string / null	Optional
`watch.observation_state.lastSuccessfulAt`	string / null	Optional
`watch.observation_state.lastHealthyAt`	string / null	Optional
`watch.observation_state.firstUnavailableAt`	string / null	Optional	UTC start of the current sequence of complete unavailability observations for the inspected source or destination; null outside that sequence.
`watch.observation_state.unavailableCount`	number	Optional	Count of complete unavailability observations in the current sequence for the inspected source or destination.
`watch.observation_state.wasEverHealthy`	boolean	Optional
`watch.observation_state.retryNotBefore`	string / null	Optional	UTC lower bound derived from the publisher’s Retry-After. The scheduler can check later; this is not an exact appointment.
`watch.observation_state.ignored`	boolean	Optional	True when the reducer ignores an old, same-time or already-recorded attempt without advancing saved state.
`watch.observation_state.absentCount`	integer	Optional	Detailed source-link state: accepted complete absent observations in the current sequence. Present or source-unavailable observations reset it; an unknown attempt preserves it. minimum: `0`
`watch.observation_state.wasEverPresent`	boolean	Optional	Detailed source-link state: a complete present observation was recorded previously. This historical flag does not establish current presence.
`watch.observation_state.sourceUnavailableConfirmed`	boolean	Optional	Detailed source-link state: repeated complete source-unavailability observations satisfied the confirmation window. An unknown attempt can preserve this historical flag; it does not establish link absence.
`watch.created_at`	string	Required	UTC timestamp when the record was created.
`watch.updated_at`	string	Required	UTC timestamp of the last record update.
`watch.last_attempt_at`	string / null	Required	UTC timestamp of the latest saved attempt, including an inconclusive attempt; null before any attempt.
`watch.last_success_at`	string / null	Required	UTC timestamp of the latest complete, conclusive observation; null before one exists. This does not mean the link was present.
`watch.last_observation_id`	string / null	Required	Identifier returned by the related operation.
`watch.next_check_at`	string / null	Required	Saved scheduling eligibility time in UTC, not a promised completion time. Read status before treating it as an active schedule.
`watch.overdue_reason`	string / null	Required	Recorded scheduling or admission delay; null when no delay reason is saved.
`watch.google_crawlable`	boolean / null	Optional	Googlebot robots.txt permission on the latest checked source and observed redirect hops: true allowed, false blocked, null unknown. Does not establish Google indexing, page availability or ranking.
`watch.google_crawl_reason`	string / null	Optional	Recorded Googlebot robots permission or why that permission is unknown. Separate from permission for AgentLinkOps monitoring.
`watch.robots_rule`	string / null	Optional	Publisher robots.txt path rule supporting the current Googlebot decision, or null when no matching rule was observed.
`watch.noindex`	boolean / null	Optional	Whether the most recently completely read page told Googlebot not to index it. Null means not observed; check page_observed_at for retained older evidence.
`watch.page_nofollow`	boolean / null	Optional	Whether the most recently completely read page told Googlebot not to follow its links. Independent of individual link rel attributes; null means not observed.
`watch.link_rel`	array / null	Optional	Sorted union of rel attributes on directly observed matching link occurrences. An empty array is an observed ordinary link; null means no current or retained link attributes were observed.
`watch.can_verify_reason`	string / null	Optional	Why the latest check could not verify link presence or absence. Null means that check completed; not_checked means no check is retained.
`watch.last_verified_at`	string / null	Optional	Original timestamp of the most recent complete link presence or absence check. It stays unchanged after a blocked or incomplete check.
`watch.crawlability_provenance`	object	Optional	Original saved check times and observation IDs for robots permission, page directives and link attributes. Retained page/link facts can predate the latest robots check.
`watch.crawlability_provenance.robots_observed_at`	string / null	Required	Timestamp of the latest saved check containing the robots permission attempt, including unknown results.
`watch.crawlability_provenance.page_observed_at`	string / null	Required	Timestamp of the complete source page read supporting the page directives, or null when no complete page is retained.
`watch.crawlability_provenance.link_observed_at`	string / null	Required	Timestamp of the complete source page read where matching links were present, or null when no matching link was observed.
`watch.crawlability_provenance.robots_observation_id`	string / null	Required	Saved observation supporting the latest robots permission attempt, or null.
`watch.crawlability_provenance.page_observation_id`	string / null	Required	Saved observation supporting the page directives, or null.
`watch.crawlability_provenance.link_observation_id`	string / null	Required	Saved observation where the matching link was present, or null.
`watch.category_contract`	string	Optional	Version of the shared table, API and export category projection. must equal `"link-category-v1"`
`watch.chosen_category`	object	Optional	The saved choice and recorded account attribution. Cleared keeps the type empty; automatic permits eligible existing page evidence to supply the displayed category. Neither action reviews or starts AI work.
`watch.chosen_category.intent`	string	Required	values: `"chosen"`, `"cleared"`, `"automatic"`
`watch.chosen_category.id`	string / null	Required	Resource identifier returned by the operation.
`watch.chosen_category.name`	string / null	Required
`watch.chosen_category.standard_name`	string / null	Required
`watch.chosen_category.actor_id`	string / null	Required	Identifier returned by the related operation.
`watch.chosen_category.recorded_at`	string / null	Required
`watch.chosen_category.revision`	integer	Required	Saved label revision; pass as revision to set_link_type. Required for intent=automatic. minimum: `0`; maximum: `9007199254740991`
`watch.chosen_category.deliberate_clear`	boolean	Required
`watch.page_assessment`	object	Optional	What retained page evidence says about link occurrences. Applicability separates current, previous, expired and unavailable evidence. Suggested is provisional; accepted_manual requires a recorded review; accepted_auto requires a qualified saved policy.
`watch.page_assessment.status`	string	Required	Resource lifecycle status. values: `"ready"`, `"unavailable"`
`watch.page_assessment.reason`	string	Required	Recorded explanation; null when no explanation applies.
`watch.page_assessment.read_reason`	string / null	Required
`watch.page_assessment.explanation`	string	Required
`watch.page_assessment.applicability`	string	Required
`watch.page_assessment.binding`	object / null	Required
`watch.page_assessment.binding.workspaceId`	string	Required	Identifier returned by the related operation.
`watch.page_assessment.binding.projectId`	string	Required	Identifier returned by the related operation.
`watch.page_assessment.binding.watchId`	string	Required	Identifier returned by the related operation.
`watch.page_assessment.capture`	object / null	Required
`watch.page_assessment.capture.id`	string	Required	Resource identifier returned by the operation.
`watch.page_assessment.capture.manifest_id`	string / null	Required	Identifier returned by the related operation.
`watch.page_assessment.capture.observation_id`	string / null	Required	Identifier returned by the related operation.
`watch.page_assessment.capture.observed_at`	string / null	Required	UTC timestamp of the observation used here.
`watch.page_assessment.capture.expires_at`	string / null	Required
`watch.page_assessment.source`	object / null	Required
`watch.page_assessment.source.state`	string / null	Required	Saved lifecycle or evidence state, as enumerated for this record.
`watch.page_assessment.source.observed_at`	string / null	Required	UTC timestamp of the observation used here.
`watch.page_assessment.source.observation_id`	string / null	Required	Identifier returned by the related operation.
`watch.page_assessment.source.pageUnavailable`	boolean	Required
`watch.page_assessment.assessed_at`	string / null	Required
`watch.page_assessment.revision`	integer / null	Required	Highest retained eligible occurrence decision or review revision, or null. Evidence provenance, not a write token.
`watch.page_assessment.model_revisions`	array	Required
`watch.page_assessment.model_revisions[].model`	string	Required
`watch.page_assessment.model_revisions[].revision`	string / null	Required	Recorded model version or revision, or null. Evidence provenance, not a write token.
`watch.page_assessment.policy_revisions`	array	Required
`watch.page_assessment.policy_revisions[].taxonomy_version`	string / null	Required
`watch.page_assessment.policy_revisions[].rubric_version`	string / null	Required
`watch.page_assessment.policy_revisions[].policy_revision`	string / number / null	Required	Recorded policy revision as a string or number, or null. Evidence provenance, not a write token.
`watch.page_assessment.roles`	array	Required
`watch.page_assessment.roles[].id`	string	Required	Resource identifier returned by the operation. values: `"contextual_citation"`, `"guest_post"`, `"recommendation"`, `"resource_entry"`, `"technical_reference"`, `"directory_entry"`, `"profile_website"`, `"author_attribution"`, `"discussion_contribution"`, `"navigation_template"`, `"badge_embed_attribution"`, `"partner_sponsor"`, `"other"`
`watch.page_assessment.roles[].name`	string	Required
`watch.page_assessment.roles[].standard_name`	string	Required
`watch.page_assessment.roles[].count`	integer	Required	minimum: `0`; maximum: `9007199254740991`
`watch.page_assessment.roles[].states`	object	Required
`watch.page_assessment.roles[].states.suggested`	integer	Required	minimum: `0`; maximum: `9007199254740991`
`watch.page_assessment.roles[].states.accepted_manual`	integer	Required	minimum: `0`; maximum: `9007199254740991`
`watch.page_assessment.roles[].states.accepted_auto`	integer	Required	minimum: `0`; maximum: `9007199254740991`
`watch.page_assessment.decision_state`	string	Required	values: `"suggested"`, `"accepted_manual"`, `"accepted_auto"`, `"mixed"`, `"none"`
`watch.page_assessment.mixed`	boolean	Required
`watch.page_assessment.coverage`	object	Required	Occurrence counts for this watch. Null means unavailable. Assessed counts completed evaluations, including inconclusive ones. Classified counts occurrences with a determined role; partial describes type coverage. Retained includes excluded occurrences. Counts do not represent separate watched links.
`watch.page_assessment.coverage.assessed`	integer / null	Required
`watch.page_assessment.coverage.classified`	integer / null	Required
`watch.page_assessment.coverage.eligible`	integer / null	Required
`watch.page_assessment.coverage.retained`	integer / null	Required
`watch.page_assessment.coverage.excluded`	integer / null	Required
`watch.page_assessment.coverage.unassessed`	integer / null	Required
`watch.page_assessment.coverage.unclassified`	integer / null	Required
`watch.page_assessment.coverage.partial`	boolean / null	Required
`watch.page_assessment.pending_count`	integer / null	Required
`watch.page_assessment.failed_count`	integer / null	Required
`watch.page_assessment.job_count`	integer / null	Required
`watch.page_assessment.review_required_count`	integer / null	Required
`watch.display_category`	object	Optional	The category shown in the everyday table. A deliberate saved choice takes precedence. Otherwise page evidence supplies a category or Mixed types, with its evidence state. Read the reason when no category is available.
`watch.display_category.source`	string	Required	values: `"chosen"`, `"page_assessment"`, `"none"`
`watch.display_category.kind`	string	Required	values: `"category"`, `"mixed"`, `"cleared"`, `"unknown"`
`watch.display_category.id`	string / null	Required	Resource identifier returned by the operation.
`watch.display_category.name`	string	Required
`watch.display_category.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record.
`watch.display_category.reason`	string	Required	Recorded explanation; null when no explanation applies.
`watch.display_category.applicability`	string	Required
`watch.display_category.coverage`	object	Required	Occurrence counts for this watch. Null means unavailable. Assessed counts completed evaluations, including inconclusive ones. Classified counts occurrences with a determined role; partial describes type coverage. Retained includes excluded occurrences. Counts do not represent separate watched links.
`watch.display_category.coverage.assessed`	integer / null	Required
`watch.display_category.coverage.classified`	integer / null	Required
`watch.display_category.coverage.eligible`	integer / null	Required
`watch.display_category.coverage.retained`	integer / null	Required
`watch.display_category.coverage.excluded`	integer / null	Required
`watch.display_category.coverage.unassessed`	integer / null	Required
`watch.display_category.coverage.unclassified`	integer / null	Required
`watch.display_category.coverage.partial`	boolean / null	Required
`watch.source_url`	string	Required	Publisher page URL recorded in this evidence.
`watch.target_url`	string	Required	Destination URL recorded in this evidence.
`watch.target_scope`	string	Required
`watch.expected_anchor`	string / null	Required
`watch.expected_rel`	array / null	Required
`watch.local_reference`	string / null	Required	Customer reference for joining this record to a local ledger entry.
`watch.last_successful_observation_id`	string / null	Required	Identifier returned by the related operation.
`watch.history_compacted_before`	string / null	Optional	Retention cutoff for compacted history; null when no cutoff is recorded. It does not establish that no earlier observations existed.
`watch.archived_at`	string / null	Optional
`watch.provider_metrics`	object / object / object	Optional
`watch.provider_metrics.dataforseo`	object	Required	additional fields rejected
`watch.provider_metrics.dataforseo.rank`	integer / null	Required
`watch.provider_metrics.dataforseo.page_from_rank`	integer / null	Required
`watch.provider_metrics.dataforseo.domain_from`	string	Optional	minLength: `1`; maxLength: `253`
`watch.provider_metrics.dataforseo.domain_from_rank`	integer / null	Required
`watch.provider_metrics.dataforseo.backlink_spam_score`	integer / null	Required
`watch.provider_metrics.dataforseo.rank_scale`	string	Required	must equal `"one_thousand"`
`watch.provider_metrics.imported`	object	Required	additional fields rejected
`watch.provider_metrics.imported.supplier`	string	Required	values: `"ahrefs"`, `"google_search_console"`, `"bing_webmaster_tools"`, `"semrush"`, `"majestic"`, `"moz"`, `"dataforseo"`, `"linkody"`, `"csv"`
`watch.provider_metrics.imported.supplier_row_id`	string / null	Required	Identifier returned by the related operation.
`watch.provider_metrics.imported.target_basis`	string	Optional	values: `"supplier_observed"`, `"user_supplied_target_expectation"`
`watch.provider_metrics.imported.supplier_generated_at`	string / null	Required
`watch.provider_metrics.imported.supplier_metrics`	object / null	Required
`watch.provider_metrics.linktrail_corpus`	object	Required	additional fields rejected
`watch.provider_metrics.linktrail_corpus.source_outlink_count`	integer / null	Required
`watch.provider_metrics.linktrail_corpus.source_external_outlink_count`	integer / null	Required
`watch.provider_metrics.linktrail_corpus.fetch_kind`	string	Required	values: `"direct"`, `"rendered"`, `"proxied"`
`watch.provider_metrics.linktrail_corpus.extraction_complete`	boolean	Required
`watch.provider_metrics_retrieved_at`	string / null	Optional
`watch.provider_metrics_data_mode`	string	Optional
`watch.initial_check`	object	Optional
`watch.initial_check.job_id`	string / null	Required	Identifier returned by the related operation.
`watch.initial_check.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record.
`watch.initial_check.error_code`	string / null	Required	Error code recorded for this result, or null.
`watch.check_operation`	object	Optional	additional fields rejected
`watch.check_operation.id`	string	Required	Resource identifier returned by the operation.
`watch.check_operation.watch_id`	string	Required	Identifier returned by the related operation.
`watch.check_operation.operation_key`	string	Required
`watch.check_operation.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"pending"`, `"running"`, `"completed"`, `"partial"`
`watch.check_operation.source`	object	Required	additional fields rejected
`watch.check_operation.source.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"queued"`, `"running"`, `"completed"`, `"skipped"`, `"unavailable"`, `"failed"`, `"waiting_source"`
`watch.check_operation.source.job_id`	string / null	Required	Identifier returned by the related operation.
`watch.check_operation.source.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`watch.check_operation.source.result`	string / null	Required	Saved result; null when this operation has no completed result.
`watch.check_operation.source.lane`	string / null	Required
`watch.check_operation.source.last_crawl_at`	string / null	Optional
`watch.check_operation.source.retrieved_at`	string / null	Optional
`watch.check_operation.target`	object	Required	additional fields rejected
`watch.check_operation.target.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"queued"`, `"running"`, `"completed"`, `"skipped"`, `"unavailable"`, `"failed"`, `"waiting_source"`
`watch.check_operation.target.job_id`	string / null	Required	Identifier returned by the related operation.
`watch.check_operation.target.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`watch.check_operation.target.result`	string / null	Required	Saved result; null when this operation has no completed result.
`watch.check_operation.target.lane`	string / null	Required
`watch.check_operation.target.last_crawl_at`	string / null	Optional
`watch.check_operation.target.retrieved_at`	string / null	Optional
`watch.check_operation.classification`	object	Required	additional fields rejected
`watch.check_operation.classification.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"queued"`, `"running"`, `"completed"`, `"skipped"`, `"unavailable"`, `"failed"`, `"waiting_source"`
`watch.check_operation.classification.job_id`	string / null	Required	Identifier returned by the related operation.
`watch.check_operation.classification.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`watch.check_operation.classification.result`	string / null	Required	Saved result; null when this operation has no completed result.
`watch.check_operation.classification.lane`	string / null	Required
`watch.check_operation.classification.last_crawl_at`	string / null	Optional
`watch.check_operation.classification.retrieved_at`	string / null	Optional
`watch.check_operation.google`	object	Required	additional fields rejected
`watch.check_operation.google.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"queued"`, `"running"`, `"completed"`, `"skipped"`, `"unavailable"`, `"failed"`, `"waiting_source"`
`watch.check_operation.google.job_id`	string / null	Required	Identifier returned by the related operation.
`watch.check_operation.google.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`watch.check_operation.google.result`	string / null	Required	Saved result; null when this operation has no completed result.
`watch.check_operation.google.lane`	string / null	Required
`watch.check_operation.google.last_crawl_at`	string / null	Optional
`watch.check_operation.google.retrieved_at`	string / null	Optional
`watch.check_operation.authority`	object	Required	additional fields rejected
`watch.check_operation.authority.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"queued"`, `"running"`, `"completed"`, `"skipped"`, `"unavailable"`, `"failed"`, `"waiting_source"`
`watch.check_operation.authority.job_id`	string / null	Required	Identifier returned by the related operation.
`watch.check_operation.authority.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`watch.check_operation.authority.result`	string / null	Required	Saved result; null when this operation has no completed result.
`watch.check_operation.authority.lane`	string / null	Required
`watch.check_operation.authority.last_crawl_at`	string / null	Optional
`watch.check_operation.authority.retrieved_at`	string / null	Optional
`watch.check_operation.follow_up_required`	boolean	Required
`watch.check_status`	object / null	Optional
`watch.check_status.version`	number	Required	must equal `1`
`watch.check_status.monitoring`	object	Required	additional fields rejected
`watch.check_status.monitoring.mode`	string	Required	values: `"monitored"`, `"paused"`, `"not_monitored"`, `"removed"`
`watch.check_status.monitoring.cadence_seconds`	number / null	Required	Configured check interval in seconds. Scheduling and admission can delay completion.
`watch.check_status.monitoring.next_check_at`	string / null	Required	Saved scheduling eligibility time in UTC, not a promised completion time. Read status before treating it as an active schedule.
`watch.check_status.can_check`	boolean	Required
`watch.check_status.check_blocked_reason`	string / null	Required
`watch.check_status.stages`	object	Required	additional fields rejected
`watch.check_status.stages.link`	object	Required
`watch.check_status.stages.link.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"checked"`, `"stale"`, `"running"`, `"failed"`, `"not_checked"`, `"unavailable"`, `"not_applicable"`
`watch.check_status.stages.link.checked_at`	string / null	Required	UTC timestamp of the saved check.
`watch.check_status.stages.link.result`	string / null	Required	Saved result; null when this operation has no completed result.
`watch.check_status.stages.link.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`watch.check_status.stages.link.refresh`	string	Required	values: `"automatic"`, `"with_check"`, `"not_refreshed"`, `"none"`
`watch.check_status.stages.destination`	object	Required
`watch.check_status.stages.destination.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"checked"`, `"stale"`, `"running"`, `"failed"`, `"not_checked"`, `"unavailable"`, `"not_applicable"`
`watch.check_status.stages.destination.checked_at`	string / null	Required	UTC timestamp of the saved check.
`watch.check_status.stages.destination.result`	string / null	Required	Saved result; null when this operation has no completed result.
`watch.check_status.stages.destination.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`watch.check_status.stages.destination.refresh`	string	Required	values: `"automatic"`, `"with_check"`, `"not_refreshed"`, `"none"`
`watch.check_status.stages.link_type`	object	Required
`watch.check_status.stages.link_type.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"checked"`, `"stale"`, `"running"`, `"failed"`, `"not_checked"`, `"unavailable"`, `"not_applicable"`
`watch.check_status.stages.link_type.checked_at`	string / null	Required	UTC timestamp of the saved check.
`watch.check_status.stages.link_type.result`	string / null	Required	Saved result; null when this operation has no completed result.
`watch.check_status.stages.link_type.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`watch.check_status.stages.link_type.refresh`	string	Required	values: `"automatic"`, `"with_check"`, `"not_refreshed"`, `"none"`
`watch.check_status.stages.google`	object	Required
`watch.check_status.stages.google.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"checked"`, `"stale"`, `"running"`, `"failed"`, `"not_checked"`, `"unavailable"`, `"not_applicable"`
`watch.check_status.stages.google.checked_at`	string / null	Required	UTC timestamp of the saved check.
`watch.check_status.stages.google.result`	string / null	Required	Saved result; null when this operation has no completed result.
`watch.check_status.stages.google.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`watch.check_status.stages.google.refresh`	string	Required	values: `"automatic"`, `"with_check"`, `"not_refreshed"`, `"none"`
`watch.check_status.stages.authority`	object	Required
`watch.check_status.stages.authority.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"checked"`, `"stale"`, `"running"`, `"failed"`, `"not_checked"`, `"unavailable"`, `"not_applicable"`
`watch.check_status.stages.authority.checked_at`	string / null	Required	UTC timestamp of the saved check.
`watch.check_status.stages.authority.result`	string / null	Required	Saved result; null when this operation has no completed result.
`watch.check_status.stages.authority.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`watch.check_status.stages.authority.refresh`	string	Required	values: `"automatic"`, `"with_check"`, `"not_refreshed"`, `"none"`
`watch.check_status.last_run`	object / null	Required
`watch.check_status.last_run.id`	string	Required	Resource identifier returned by the operation.
`watch.check_status.last_run.watch_id`	string	Required	Identifier returned by the related operation.
`watch.check_status.last_run.operation_key`	string	Required
`watch.check_status.last_run.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"pending"`, `"running"`, `"completed"`, `"partial"`
`watch.check_status.last_run.source`	object	Required	additional fields rejected
`watch.check_status.last_run.source.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"queued"`, `"running"`, `"completed"`, `"skipped"`, `"unavailable"`, `"failed"`, `"waiting_source"`
`watch.check_status.last_run.source.job_id`	string / null	Required	Identifier returned by the related operation.
`watch.check_status.last_run.source.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`watch.check_status.last_run.source.result`	string / null	Required	Saved result; null when this operation has no completed result.
`watch.check_status.last_run.source.lane`	string / null	Required
`watch.check_status.last_run.source.last_crawl_at`	string / null	Optional
`watch.check_status.last_run.source.retrieved_at`	string / null	Optional
`watch.check_status.last_run.target`	object	Required	additional fields rejected
`watch.check_status.last_run.target.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"queued"`, `"running"`, `"completed"`, `"skipped"`, `"unavailable"`, `"failed"`, `"waiting_source"`
`watch.check_status.last_run.target.job_id`	string / null	Required	Identifier returned by the related operation.
`watch.check_status.last_run.target.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`watch.check_status.last_run.target.result`	string / null	Required	Saved result; null when this operation has no completed result.
`watch.check_status.last_run.target.lane`	string / null	Required
`watch.check_status.last_run.target.last_crawl_at`	string / null	Optional
`watch.check_status.last_run.target.retrieved_at`	string / null	Optional
`watch.check_status.last_run.classification`	object	Required	additional fields rejected
`watch.check_status.last_run.classification.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"queued"`, `"running"`, `"completed"`, `"skipped"`, `"unavailable"`, `"failed"`, `"waiting_source"`
`watch.check_status.last_run.classification.job_id`	string / null	Required	Identifier returned by the related operation.
`watch.check_status.last_run.classification.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`watch.check_status.last_run.classification.result`	string / null	Required	Saved result; null when this operation has no completed result.
`watch.check_status.last_run.classification.lane`	string / null	Required
`watch.check_status.last_run.classification.last_crawl_at`	string / null	Optional
`watch.check_status.last_run.classification.retrieved_at`	string / null	Optional
`watch.check_status.last_run.google`	object	Required	additional fields rejected
`watch.check_status.last_run.google.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"queued"`, `"running"`, `"completed"`, `"skipped"`, `"unavailable"`, `"failed"`, `"waiting_source"`
`watch.check_status.last_run.google.job_id`	string / null	Required	Identifier returned by the related operation.
`watch.check_status.last_run.google.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`watch.check_status.last_run.google.result`	string / null	Required	Saved result; null when this operation has no completed result.
`watch.check_status.last_run.google.lane`	string / null	Required
`watch.check_status.last_run.google.last_crawl_at`	string / null	Optional
`watch.check_status.last_run.google.retrieved_at`	string / null	Optional
`watch.check_status.last_run.authority`	object	Required	additional fields rejected
`watch.check_status.last_run.authority.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"queued"`, `"running"`, `"completed"`, `"skipped"`, `"unavailable"`, `"failed"`, `"waiting_source"`
`watch.check_status.last_run.authority.job_id`	string / null	Required	Identifier returned by the related operation.
`watch.check_status.last_run.authority.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`watch.check_status.last_run.authority.result`	string / null	Required	Saved result; null when this operation has no completed result.
`watch.check_status.last_run.authority.lane`	string / null	Required
`watch.check_status.last_run.authority.last_crawl_at`	string / null	Optional
`watch.check_status.last_run.authority.retrieved_at`	string / null	Optional
`watch.check_status.last_run.follow_up_required`	boolean	Required
`watch.check_status.last_run.created_at`	string	Required	UTC timestamp when the record was created.
`watch.check_status.last_run.updated_at`	string	Required	UTC timestamp of the last record update.
`watch.check_status.last_run.expires_at`	string	Required
`watch.check_status.last_run.expired`	boolean	Required
`watch.candidate_only`	number	Optional
`watch.created`	boolean	Optional	True when this request created the record; false when an existing record was reused.
`watch.detail`	string	Optional
`watch.type`	string,null	Optional	Saved compatibility type on enriched watch records; null when empty. Prefer display_category for the category shown in the table and page_assessment for currentness. A saved model type alone does not prove a current assessment. Reading or checking a link does not classify it. Deployments without label tables omit this field; concise list rows omit it too. values: `"contextual_citation"`, `"guest_post"`, `"recommendation"`, `"resource_entry"`, `"technical_reference"`, `"directory_entry"`, `"profile_website"`, `"author_attribution"`, `"discussion_contribution"`, `"navigation_template"`, `"badge_embed_attribution"`, `"partner_sponsor"`, `"other"`, `null`
`watch.type_source`	string,null	Optional	Who supplied the saved compatibility value: person includes a team choice or deliberate clear; model identifies a saved model type. A null value can accompany automatic display; read chosen_category.intent for the team intent. Classification updates preserve team choices and clears. Deployments without label tables and concise list rows omit this field. values: `"person"`, `"model"`, `null`
`watch.type_revision`	integer	Optional	Saved compatibility label revision; zero when no label record exists. Use chosen_category.revision for set_link_type conflict checks. Deployments without label tables and concise list rows omit this field. minimum: `0`
`watch.tags`	array	Optional	Active workspace tags attached to this watch, ordered by name; an empty array means the watch has no active tags. Tags remain separate from the chosen category and page assessment. Checking a link does not add tags. Deployments without label tables and concise list rows omit this field.
`watch.tags[].id`	string	Required	Workspace tag identifier returned by list_link_tags or save_link_tag.
`watch.tags[].name`	string	Required	Saved display name of the attached workspace tag.
`watch.tags[].color`	string	Required	Saved display color of the attached workspace tag.
`watch.disavow`	string,null	Optional	Saved rule coverage for this source: active for an approved rule, proposed for a suggestion, or null when no rule covers it or rule metadata is unavailable. An active rule takes precedence over a proposed rule. Concise list rows omit this field; reading this coverage does not submit a disavow file to Google. values: `"active"`, `"proposed"`, `null`
`replayed`	boolean	Required	True when the response reuses an earlier request with the same idempotency value.
`recurring_monitoring_created`	boolean	Required	Whether this operation enrolled recurring monitoring.
`enrollment_outcome`	string	Optional	values: `"created"`, `"already_monitored"`

Download input schema · Download output schema

Errors and retries

When retrying with idempotencyKey, reuse the original value and the same arguments; preserve originally omitted optional fields. Generic HTTP puts idempotencyKey in the JSON body, while resource routes use the header where listed below. A changed payload under a reused key can conflict. See error recovery for status, scope, cooldown, cursor and retry handling. Unknown observations are result data and do not establish loss.

HTTP resource routes

These existing resource routes share the operation’s domain behavior. Their parameter placement, status and response envelope can differ from generic invocation. See HTTP route details.

Method and route	Success	Details
`POST /v1/discovery/verifications/{jobId}/monitor`	200	Remaining arguments go in a JSON object body. Supply idempotencyKey as the Idempotency-Key header on this resource route.

Continue

get_link_watch Follow the related workflow. See capability status for availability or the command index for another operation.

Overview

MCP, CLI and API commands

CLI client

HTTP and events

Optional local workflows

Monitor discovery candidate

Example request

Returned result

Input fields

Validation and omitted values

Defaults when omitted

Output fields

Errors and retries

HTTP resource routes

Continue

​Example request

​Returned result

​Input fields

​Validation and omitted values

​Defaults when omitted

​Output fields

​Errors and retries

​HTTP resource routes

​Continue

Example request

Returned result

Input fields

Validation and omitted values

Defaults when omitted

Output fields

Errors and retries

HTTP resource routes

Continue