Import link watches

import_link_watches Import up to 100 backlinks with per-row errors. accepted includes existing watches; created counts new watches. Valid rows continue.

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
`watches:write`	Writes or admits work

This operation changes saved state. Review its inputs and retry behavior before calling.

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": "import_link_watches",
    "arguments": {
      "projectId": "project_example",
      "watches": [
        {
          "sourceUrl": "https://publisher.example.com/resources",
          "targetUrl": "https://example.com/guide"
        }
      ]
    }
  }
}

agentlinkops call import_link_watches --args '{"projectId":"project_example","watches":[{"sourceUrl":"https://publisher.example.com/resources","targetUrl":"https://example.com/guide"}]}'

curl --fail-with-body https://app.agentlinkops.com/v1/commands/import_link_watches \
  -H "Authorization: Bearer $AGENTLINKOPS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"projectId":"project_example","watches":[{"sourceUrl":"https://publisher.example.com/resources","targetUrl":"https://example.com/guide"}]}'

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

{
  "status": "succeeded",
  "rows": [
    {
      "index": 0,
      "watch": {
        "workspace_id": "ws_example",
        "project_id": "project_example",
        "status": "active",
        "cadence_seconds": 86400,
        "state": "unknown",
        "observation_state": {},
        "created_at": "2026-09-13T12:00:00.000Z",
        "updated_at": "2026-09-13T12:00:00.000Z",
        "last_attempt_at": null,
        "last_success_at": null,
        "last_observation_id": null,
        "next_check_at": "2026-09-13T12:00:00.000Z",
        "overdue_reason": null,
        "id": "watch_example_1",
        "source_url": "https://publisher.example.com/resources",
        "target_url": "https://example.com/guide",
        "target_scope": "exact",
        "expected_anchor": null,
        "expected_rel": null,
        "local_reference": null,
        "last_successful_observation_id": null,
        "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
        },
        "created": true
      }
    }
  ],
  "imported": 1,
  "accepted": 1,
  "created": 1,
  "existing": 0,
  "failed": 0
}

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
`projectId`	string	Required	project ID from create/list. minLength: `1`; maxLength: `200`
`watches`	array	Required	Watch URL fields, or runId/candidateId for saved import URLs/scope. Source-only Search Console rows match any page on the imported website. minItems: `1`; maxItems: `100`
`watches[].intent`	string	Optional	values: `"prospect"`, `"earned"`, `"retired"`
`watches[].outreachStatus`	string / null	Optional
`watches[].lastContactedAt`	string / null	Optional
`watches[].campaign`	string / null	Optional
`watches[].sourceUrl`	string	Required	format: `"uri"`
`watches[].targetUrl`	string	Required	format: `"uri"`
`watches[].targetScope`	string	Optional	values: `"exact"`, `"domain"`, `"subdomain"`, `"path"`
`watches[].cadenceSeconds`	integer	Optional	minimum: `3600`; maximum: `2592000`
`watches[].expectedAnchor`	string / null	Optional
`watches[].expectedRel`	array / null	Optional
`watches[].localReference`	string	Optional	maxLength: `200`
`watches[].runId`	string	Required	Identifier returned by the related operation. pattern: `"^[a-zA-Z0-9_-]{1,128}$"`
`watches[].candidateId`	string	Required	Identifier returned by the related operation. pattern: `"^dc_[a-f0-9]{64}$"`

Validation and omitted values

Each watch row uses monitor_link defaults: targetScope exact and cadenceSeconds 86400 when omitted; omitted expectations and localReference are empty. Each row is processed separately. Invalid rows produce indexed errors while valid rows continue. accepted includes reused watches; created counts only new watches. Relation expectations allow at most twenty tokens, each one to forty letters, digits, _ or -; values are lowercased, deduplicated and sorted.

Output fields

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

status (string, required): Resource lifecycle status.
admission (object / null, optional).
rows (array, required).
imported (number, required).
accepted (number, required).
created (number, required): Number of records created by this operation.
existing (number, required).
failed (number, required).

All fields and nested objects

Types, allowed values, limits and nested fields:

Field	Type	Presence	Meaning and constraints
`status`	string	Required	Resource lifecycle status.
`admission`	object / null	Optional
`admission.operation_id`	string	Required	Identifier returned by the related operation. minLength: `1`; maxLength: `200`
`admission.project_id`	string	Required	Project that owns this record. minLength: `1`; maxLength: `200`
`admission.context`	string	Required	values: `"import"`, `"candidate"`, `"candidate_batch"`, `"serve"`
`admission.decisions`	array	Required
`admission.decisions[].index`	integer	Required	minimum: `0`; maximum: `9007199254740991`
`admission.decisions[].url`	string	Required
`admission.decisions[].normalized_url`	string / null	Required
`admission.decisions[].host`	string / null	Required
`admission.decisions[].decision`	string	Required	values: `"admitted"`, `"rejected"`
`admission.decisions[].reason`	string	Required	Recorded explanation; null when no explanation applies.
`admission.decisions[].rule_kind`	string / null	Required
`admission.decisions[].rule_id`	string / null	Required	Identifier returned by the related operation.
`admission.decisions[].rule_value`	string / null	Required
`admission.decisions[].cap`	object / null	Required
`admission.decisions[].cap.limit`	integer	Required	maximum: `9007199254740991`; exclusiveMinimum: `0`
`admission.decisions[].cap.used`	integer	Required	minimum: `0`; maximum: `9007199254740991`
`admission.decisions[].subject_key`	string	Required	minLength: `1`; maxLength: `200`
`admission.summary`	object	Required	additional fields rejected
`admission.summary.total`	integer	Required	minimum: `-9007199254740991`; maximum: `9007199254740991`
`admission.summary.admitted`	integer	Required	minimum: `-9007199254740991`; maximum: `9007199254740991`
`admission.summary.rejected`	integer	Required	minimum: `-9007199254740991`; maximum: `9007199254740991`
`admission.summary.by_rule`	object	Required
`admission.policy_revision`	integer	Required	minimum: `0`; maximum: `9007199254740991`
`admission.disavow_revision`	integer	Required	minimum: `0`; maximum: `9007199254740991`
`admission.replayed`	boolean	Required	True when the response reuses an earlier request with the same idempotency value.
`rows`	array	Required
`rows[].index`	number	Required
`rows[].watch`	object	Optional
`rows[].watch.intent`	string	Optional	values: `"prospect"`, `"earned"`, `"retired"`
`rows[].watch.outreachStatus`	string / null	Optional
`rows[].watch.lastContactedAt`	string / null	Optional
`rows[].watch.campaign`	string / null	Optional
`rows[].watch.id`	string	Required	Resource identifier returned by the operation.
`rows[].watch.workspace_id`	string	Required	Workspace that owns this record.
`rows[].watch.project_id`	string	Required	Project that owns this record.
`rows[].watch.status`	string	Required	Resource lifecycle status. values: `"active"`, `"paused"`
`rows[].watch.cadence_seconds`	number	Required	Configured check interval in seconds. Scheduling and admission can delay completion.
`rows[].watch.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record.
`rows[].watch.observation_state`	object	Required	Saved observation state. Before the first check, this object can be empty.
`rows[].watch.observation_state.state`	string	Optional	Saved lifecycle or evidence state, as enumerated for this record.
`rows[].watch.observation_state.uncertain`	boolean	Optional	True when the latest attempt is inconclusive. Earlier conclusive state can remain recorded beside it.
`rows[].watch.observation_state.checked_at`	string	Optional	UTC timestamp of the saved check.
`rows[].watch.observation_state.lastChangedAt`	string / null	Optional
`rows[].watch.observation_state.firstAbsentAt`	string / null	Optional	UTC start of the current sequence of complete absent observations; null outside that sequence.
`rows[].watch.observation_state.nextCheckAt`	string / null	Optional	Confirmation-check eligibility requested by the state reducer; null when no extra confirmation check is requested.
`rows[].watch.observation_state.reason`	string / null	Optional	Recorded explanation; null when no explanation applies.
`rows[].watch.observation_state.latestAttempt`	object / null	Optional	Summary of the newest accepted attempt, including unknown or incomplete results; null before an attempt.
`rows[].watch.observation_state.latestAttempt.state`	string	Optional	Saved lifecycle or evidence state, as enumerated for this record.
`rows[].watch.observation_state.latestAttempt.reason`	string / null	Optional	Recorded explanation; null when no explanation applies.
`rows[].watch.observation_state.latestAttempt.checkedAt`	string	Optional	UTC timestamp of the summarized attempt.
`rows[].watch.observation_state.latestAttempt.httpStatus`	number / null	Optional
`rows[].watch.observation_state.latestAttempt.occurrenceCount`	number	Optional	Total matching occurrences reported by that attempt; its retained summary can contain fewer occurrence excerpts.
`rows[].watch.observation_state.latestAttempt.occurrences`	array	Optional
`rows[].watch.observation_state.latestAttempt.occurrences[].href`	string / null	Optional
`rows[].watch.observation_state.latestAttempt.occurrences[].targetUrl`	string / null	Optional
`rows[].watch.observation_state.latestAttempt.occurrences[].anchor`	string / null	Optional
`rows[].watch.observation_state.latestAttempt.occurrences[].rel`	array	Optional
`rows[].watch.observation_state.latestAttempt.occurrences[].context`	string / null	Optional
`rows[].watch.observation_state.latestAttempt.occurrences[].locator`	object / null	Optional
`rows[].watch.observation_state.latestAttempt.occurrences[].locator.line`	number / null	Optional
`rows[].watch.observation_state.latestAttempt.occurrences[].locator.column`	number / null	Optional
`rows[].watch.observation_state.latestAttempt.occurrences[].locator.offset`	number / null	Optional
`rows[].watch.observation_state.latestAttempt.checkerVersion`	string	Optional
`rows[].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.
`rows[].watch.observation_state.lastSuccessfulObservation.state`	string	Optional	Saved lifecycle or evidence state, as enumerated for this record.
`rows[].watch.observation_state.lastSuccessfulObservation.reason`	string / null	Optional	Recorded explanation; null when no explanation applies.
`rows[].watch.observation_state.lastSuccessfulObservation.checkedAt`	string	Optional	UTC timestamp of the retained conclusive observation, which can precede the latest attempt.
`rows[].watch.observation_state.lastSuccessfulObservation.httpStatus`	number / null	Optional
`rows[].watch.observation_state.lastSuccessfulObservation.occurrenceCount`	number	Optional	Total matching occurrences reported by the conclusive observation; the summary retains at most ten excerpts.
`rows[].watch.observation_state.lastSuccessfulObservation.occurrences`	array	Optional
`rows[].watch.observation_state.lastSuccessfulObservation.occurrences[].href`	string / null	Optional
`rows[].watch.observation_state.lastSuccessfulObservation.occurrences[].targetUrl`	string / null	Optional
`rows[].watch.observation_state.lastSuccessfulObservation.occurrences[].anchor`	string / null	Optional
`rows[].watch.observation_state.lastSuccessfulObservation.occurrences[].rel`	array	Optional
`rows[].watch.observation_state.lastSuccessfulObservation.occurrences[].context`	string / null	Optional
`rows[].watch.observation_state.lastSuccessfulObservation.occurrences[].locator`	object / null	Optional
`rows[].watch.observation_state.lastSuccessfulObservation.occurrences[].locator.line`	number / null	Optional
`rows[].watch.observation_state.lastSuccessfulObservation.occurrences[].locator.column`	number / null	Optional
`rows[].watch.observation_state.lastSuccessfulObservation.occurrences[].locator.offset`	number / null	Optional
`rows[].watch.observation_state.lastSuccessfulObservation.checkerVersion`	string	Optional
`rows[].watch.observation_state.lastSuccessfulObservationSameAsLatestAttempt`	boolean	Optional
`rows[].watch.observation_state.confirmedState`	string / null	Optional
`rows[].watch.observation_state.lastSuccessfulAt`	string / null	Optional
`rows[].watch.observation_state.lastHealthyAt`	string / null	Optional
`rows[].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.
`rows[].watch.observation_state.unavailableCount`	number	Optional	Count of complete unavailability observations in the current sequence for the inspected source or destination.
`rows[].watch.observation_state.wasEverHealthy`	boolean	Optional
`rows[].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.
`rows[].watch.observation_state.ignored`	boolean	Optional	True when the reducer ignores an old, same-time or already-recorded attempt without advancing saved state.
`rows[].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`
`rows[].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.
`rows[].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.
`rows[].watch.created_at`	string	Required	UTC timestamp when the record was created.
`rows[].watch.updated_at`	string	Required	UTC timestamp of the last record update.
`rows[].watch.last_attempt_at`	string / null	Required	UTC timestamp of the latest saved attempt, including an inconclusive attempt; null before any attempt.
`rows[].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.
`rows[].watch.last_observation_id`	string / null	Required	Identifier returned by the related operation.
`rows[].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.
`rows[].watch.overdue_reason`	string / null	Required	Recorded scheduling or admission delay; null when no delay reason is saved.
`rows[].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.
`rows[].watch.google_crawl_reason`	string / null	Optional	Recorded Googlebot robots permission or why that permission is unknown. Separate from permission for AgentLinkOps monitoring.
`rows[].watch.robots_rule`	string / null	Optional	Publisher robots.txt path rule supporting the current Googlebot decision, or null when no matching rule was observed.
`rows[].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.
`rows[].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.
`rows[].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.
`rows[].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.
`rows[].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.
`rows[].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.
`rows[].watch.crawlability_provenance.robots_observed_at`	string / null	Required	Timestamp of the latest saved check containing the robots permission attempt, including unknown results.
`rows[].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.
`rows[].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.
`rows[].watch.crawlability_provenance.robots_observation_id`	string / null	Required	Saved observation supporting the latest robots permission attempt, or null.
`rows[].watch.crawlability_provenance.page_observation_id`	string / null	Required	Saved observation supporting the page directives, or null.
`rows[].watch.crawlability_provenance.link_observation_id`	string / null	Required	Saved observation where the matching link was present, or null.
`rows[].watch.category_contract`	string	Optional	Version of the shared table, API and export category projection. must equal `"link-category-v1"`
`rows[].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.
`rows[].watch.chosen_category.intent`	string	Required	values: `"chosen"`, `"cleared"`, `"automatic"`
`rows[].watch.chosen_category.id`	string / null	Required	Resource identifier returned by the operation.
`rows[].watch.chosen_category.name`	string / null	Required
`rows[].watch.chosen_category.standard_name`	string / null	Required
`rows[].watch.chosen_category.actor_id`	string / null	Required	Identifier returned by the related operation.
`rows[].watch.chosen_category.recorded_at`	string / null	Required
`rows[].watch.chosen_category.revision`	integer	Required	Saved label revision; pass as revision to set_link_type. Required for intent=automatic. minimum: `0`; maximum: `9007199254740991`
`rows[].watch.chosen_category.deliberate_clear`	boolean	Required
`rows[].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.
`rows[].watch.page_assessment.status`	string	Required	Resource lifecycle status. values: `"ready"`, `"unavailable"`
`rows[].watch.page_assessment.reason`	string	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.page_assessment.read_reason`	string / null	Required
`rows[].watch.page_assessment.explanation`	string	Required
`rows[].watch.page_assessment.applicability`	string	Required
`rows[].watch.page_assessment.binding`	object / null	Required
`rows[].watch.page_assessment.binding.workspaceId`	string	Required	Identifier returned by the related operation.
`rows[].watch.page_assessment.binding.projectId`	string	Required	Identifier returned by the related operation.
`rows[].watch.page_assessment.binding.watchId`	string	Required	Identifier returned by the related operation.
`rows[].watch.page_assessment.capture`	object / null	Required
`rows[].watch.page_assessment.capture.id`	string	Required	Resource identifier returned by the operation.
`rows[].watch.page_assessment.capture.manifest_id`	string / null	Required	Identifier returned by the related operation.
`rows[].watch.page_assessment.capture.observation_id`	string / null	Required	Identifier returned by the related operation.
`rows[].watch.page_assessment.capture.observed_at`	string / null	Required	UTC timestamp of the observation used here.
`rows[].watch.page_assessment.capture.expires_at`	string / null	Required
`rows[].watch.page_assessment.source`	object / null	Required
`rows[].watch.page_assessment.source.state`	string / null	Required	Saved lifecycle or evidence state, as enumerated for this record.
`rows[].watch.page_assessment.source.observed_at`	string / null	Required	UTC timestamp of the observation used here.
`rows[].watch.page_assessment.source.observation_id`	string / null	Required	Identifier returned by the related operation.
`rows[].watch.page_assessment.source.pageUnavailable`	boolean	Required
`rows[].watch.page_assessment.assessed_at`	string / null	Required
`rows[].watch.page_assessment.revision`	integer / null	Required	Highest retained eligible occurrence decision or review revision, or null. Evidence provenance, not a write token.
`rows[].watch.page_assessment.model_revisions`	array	Required
`rows[].watch.page_assessment.model_revisions[].model`	string	Required
`rows[].watch.page_assessment.model_revisions[].revision`	string / null	Required	Recorded model version or revision, or null. Evidence provenance, not a write token.
`rows[].watch.page_assessment.policy_revisions`	array	Required
`rows[].watch.page_assessment.policy_revisions[].taxonomy_version`	string / null	Required
`rows[].watch.page_assessment.policy_revisions[].rubric_version`	string / null	Required
`rows[].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.
`rows[].watch.page_assessment.roles`	array	Required
`rows[].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"`
`rows[].watch.page_assessment.roles[].name`	string	Required
`rows[].watch.page_assessment.roles[].standard_name`	string	Required
`rows[].watch.page_assessment.roles[].count`	integer	Required	minimum: `0`; maximum: `9007199254740991`
`rows[].watch.page_assessment.roles[].states`	object	Required
`rows[].watch.page_assessment.roles[].states.suggested`	integer	Required	minimum: `0`; maximum: `9007199254740991`
`rows[].watch.page_assessment.roles[].states.accepted_manual`	integer	Required	minimum: `0`; maximum: `9007199254740991`
`rows[].watch.page_assessment.roles[].states.accepted_auto`	integer	Required	minimum: `0`; maximum: `9007199254740991`
`rows[].watch.page_assessment.decision_state`	string	Required	values: `"suggested"`, `"accepted_manual"`, `"accepted_auto"`, `"mixed"`, `"none"`
`rows[].watch.page_assessment.mixed`	boolean	Required
`rows[].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.
`rows[].watch.page_assessment.coverage.assessed`	integer / null	Required
`rows[].watch.page_assessment.coverage.classified`	integer / null	Required
`rows[].watch.page_assessment.coverage.eligible`	integer / null	Required
`rows[].watch.page_assessment.coverage.retained`	integer / null	Required
`rows[].watch.page_assessment.coverage.excluded`	integer / null	Required
`rows[].watch.page_assessment.coverage.unassessed`	integer / null	Required
`rows[].watch.page_assessment.coverage.unclassified`	integer / null	Required
`rows[].watch.page_assessment.coverage.partial`	boolean / null	Required
`rows[].watch.page_assessment.pending_count`	integer / null	Required
`rows[].watch.page_assessment.failed_count`	integer / null	Required
`rows[].watch.page_assessment.job_count`	integer / null	Required
`rows[].watch.page_assessment.review_required_count`	integer / null	Required
`rows[].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.
`rows[].watch.display_category.source`	string	Required	values: `"chosen"`, `"page_assessment"`, `"none"`
`rows[].watch.display_category.kind`	string	Required	values: `"category"`, `"mixed"`, `"cleared"`, `"unknown"`
`rows[].watch.display_category.id`	string / null	Required	Resource identifier returned by the operation.
`rows[].watch.display_category.name`	string	Required
`rows[].watch.display_category.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record.
`rows[].watch.display_category.reason`	string	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.display_category.applicability`	string	Required
`rows[].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.
`rows[].watch.display_category.coverage.assessed`	integer / null	Required
`rows[].watch.display_category.coverage.classified`	integer / null	Required
`rows[].watch.display_category.coverage.eligible`	integer / null	Required
`rows[].watch.display_category.coverage.retained`	integer / null	Required
`rows[].watch.display_category.coverage.excluded`	integer / null	Required
`rows[].watch.display_category.coverage.unassessed`	integer / null	Required
`rows[].watch.display_category.coverage.unclassified`	integer / null	Required
`rows[].watch.display_category.coverage.partial`	boolean / null	Required
`rows[].watch.source_url`	string	Required	Publisher page URL recorded in this evidence.
`rows[].watch.target_url`	string	Required	Destination URL recorded in this evidence.
`rows[].watch.target_scope`	string	Required
`rows[].watch.expected_anchor`	string / null	Required
`rows[].watch.expected_rel`	array / null	Required
`rows[].watch.local_reference`	string / null	Required	Customer reference for joining this record to a local ledger entry.
`rows[].watch.last_successful_observation_id`	string / null	Required	Identifier returned by the related operation.
`rows[].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.
`rows[].watch.archived_at`	string / null	Optional
`rows[].watch.provider_metrics`	object / object / object	Optional
`rows[].watch.provider_metrics.dataforseo`	object	Required	additional fields rejected
`rows[].watch.provider_metrics.dataforseo.rank`	integer / null	Required
`rows[].watch.provider_metrics.dataforseo.page_from_rank`	integer / null	Required
`rows[].watch.provider_metrics.dataforseo.domain_from`	string	Optional	minLength: `1`; maxLength: `253`
`rows[].watch.provider_metrics.dataforseo.domain_from_rank`	integer / null	Required
`rows[].watch.provider_metrics.dataforseo.backlink_spam_score`	integer / null	Required
`rows[].watch.provider_metrics.dataforseo.rank_scale`	string	Required	must equal `"one_thousand"`
`rows[].watch.provider_metrics.imported`	object	Required	additional fields rejected
`rows[].watch.provider_metrics.imported.supplier`	string	Required	values: `"ahrefs"`, `"google_search_console"`, `"bing_webmaster_tools"`, `"semrush"`, `"majestic"`, `"moz"`, `"dataforseo"`, `"linkody"`, `"csv"`
`rows[].watch.provider_metrics.imported.supplier_row_id`	string / null	Required	Identifier returned by the related operation.
`rows[].watch.provider_metrics.imported.target_basis`	string	Optional	values: `"supplier_observed"`, `"user_supplied_target_expectation"`
`rows[].watch.provider_metrics.imported.supplier_generated_at`	string / null	Required
`rows[].watch.provider_metrics.imported.supplier_metrics`	object / null	Required
`rows[].watch.provider_metrics.linktrail_corpus`	object	Required	additional fields rejected
`rows[].watch.provider_metrics.linktrail_corpus.source_outlink_count`	integer / null	Required
`rows[].watch.provider_metrics.linktrail_corpus.source_external_outlink_count`	integer / null	Required
`rows[].watch.provider_metrics.linktrail_corpus.fetch_kind`	string	Required	values: `"direct"`, `"rendered"`, `"proxied"`
`rows[].watch.provider_metrics.linktrail_corpus.extraction_complete`	boolean	Required
`rows[].watch.provider_metrics_retrieved_at`	string / null	Optional
`rows[].watch.provider_metrics_data_mode`	string	Optional
`rows[].watch.initial_check`	object	Optional
`rows[].watch.initial_check.job_id`	string / null	Required	Identifier returned by the related operation.
`rows[].watch.initial_check.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record.
`rows[].watch.initial_check.error_code`	string / null	Required	Error code recorded for this result, or null.
`rows[].watch.check_operation`	object	Optional	additional fields rejected
`rows[].watch.check_operation.id`	string	Required	Resource identifier returned by the operation.
`rows[].watch.check_operation.watch_id`	string	Required	Identifier returned by the related operation.
`rows[].watch.check_operation.operation_key`	string	Required
`rows[].watch.check_operation.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"pending"`, `"running"`, `"completed"`, `"partial"`
`rows[].watch.check_operation.source`	object	Required	additional fields rejected
`rows[].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"`
`rows[].watch.check_operation.source.job_id`	string / null	Required	Identifier returned by the related operation.
`rows[].watch.check_operation.source.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.check_operation.source.result`	string / null	Required	Saved result; null when this operation has no completed result.
`rows[].watch.check_operation.source.lane`	string / null	Required
`rows[].watch.check_operation.source.last_crawl_at`	string / null	Optional
`rows[].watch.check_operation.source.retrieved_at`	string / null	Optional
`rows[].watch.check_operation.target`	object	Required	additional fields rejected
`rows[].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"`
`rows[].watch.check_operation.target.job_id`	string / null	Required	Identifier returned by the related operation.
`rows[].watch.check_operation.target.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.check_operation.target.result`	string / null	Required	Saved result; null when this operation has no completed result.
`rows[].watch.check_operation.target.lane`	string / null	Required
`rows[].watch.check_operation.target.last_crawl_at`	string / null	Optional
`rows[].watch.check_operation.target.retrieved_at`	string / null	Optional
`rows[].watch.check_operation.classification`	object	Required	additional fields rejected
`rows[].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"`
`rows[].watch.check_operation.classification.job_id`	string / null	Required	Identifier returned by the related operation.
`rows[].watch.check_operation.classification.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.check_operation.classification.result`	string / null	Required	Saved result; null when this operation has no completed result.
`rows[].watch.check_operation.classification.lane`	string / null	Required
`rows[].watch.check_operation.classification.last_crawl_at`	string / null	Optional
`rows[].watch.check_operation.classification.retrieved_at`	string / null	Optional
`rows[].watch.check_operation.google`	object	Required	additional fields rejected
`rows[].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"`
`rows[].watch.check_operation.google.job_id`	string / null	Required	Identifier returned by the related operation.
`rows[].watch.check_operation.google.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.check_operation.google.result`	string / null	Required	Saved result; null when this operation has no completed result.
`rows[].watch.check_operation.google.lane`	string / null	Required
`rows[].watch.check_operation.google.last_crawl_at`	string / null	Optional
`rows[].watch.check_operation.google.retrieved_at`	string / null	Optional
`rows[].watch.check_operation.authority`	object	Required	additional fields rejected
`rows[].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"`
`rows[].watch.check_operation.authority.job_id`	string / null	Required	Identifier returned by the related operation.
`rows[].watch.check_operation.authority.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.check_operation.authority.result`	string / null	Required	Saved result; null when this operation has no completed result.
`rows[].watch.check_operation.authority.lane`	string / null	Required
`rows[].watch.check_operation.authority.last_crawl_at`	string / null	Optional
`rows[].watch.check_operation.authority.retrieved_at`	string / null	Optional
`rows[].watch.check_operation.follow_up_required`	boolean	Required
`rows[].watch.check_status`	object / null	Optional
`rows[].watch.check_status.version`	number	Required	must equal `1`
`rows[].watch.check_status.monitoring`	object	Required	additional fields rejected
`rows[].watch.check_status.monitoring.mode`	string	Required	values: `"monitored"`, `"paused"`, `"not_monitored"`, `"removed"`
`rows[].watch.check_status.monitoring.cadence_seconds`	number / null	Required	Configured check interval in seconds. Scheduling and admission can delay completion.
`rows[].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.
`rows[].watch.check_status.can_check`	boolean	Required
`rows[].watch.check_status.check_blocked_reason`	string / null	Required
`rows[].watch.check_status.stages`	object	Required	additional fields rejected
`rows[].watch.check_status.stages.link`	object	Required
`rows[].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"`
`rows[].watch.check_status.stages.link.checked_at`	string / null	Required	UTC timestamp of the saved check.
`rows[].watch.check_status.stages.link.result`	string / null	Required	Saved result; null when this operation has no completed result.
`rows[].watch.check_status.stages.link.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.check_status.stages.link.refresh`	string	Required	values: `"automatic"`, `"with_check"`, `"not_refreshed"`, `"none"`
`rows[].watch.check_status.stages.destination`	object	Required
`rows[].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"`
`rows[].watch.check_status.stages.destination.checked_at`	string / null	Required	UTC timestamp of the saved check.
`rows[].watch.check_status.stages.destination.result`	string / null	Required	Saved result; null when this operation has no completed result.
`rows[].watch.check_status.stages.destination.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.check_status.stages.destination.refresh`	string	Required	values: `"automatic"`, `"with_check"`, `"not_refreshed"`, `"none"`
`rows[].watch.check_status.stages.link_type`	object	Required
`rows[].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"`
`rows[].watch.check_status.stages.link_type.checked_at`	string / null	Required	UTC timestamp of the saved check.
`rows[].watch.check_status.stages.link_type.result`	string / null	Required	Saved result; null when this operation has no completed result.
`rows[].watch.check_status.stages.link_type.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.check_status.stages.link_type.refresh`	string	Required	values: `"automatic"`, `"with_check"`, `"not_refreshed"`, `"none"`
`rows[].watch.check_status.stages.google`	object	Required
`rows[].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"`
`rows[].watch.check_status.stages.google.checked_at`	string / null	Required	UTC timestamp of the saved check.
`rows[].watch.check_status.stages.google.result`	string / null	Required	Saved result; null when this operation has no completed result.
`rows[].watch.check_status.stages.google.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.check_status.stages.google.refresh`	string	Required	values: `"automatic"`, `"with_check"`, `"not_refreshed"`, `"none"`
`rows[].watch.check_status.stages.authority`	object	Required
`rows[].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"`
`rows[].watch.check_status.stages.authority.checked_at`	string / null	Required	UTC timestamp of the saved check.
`rows[].watch.check_status.stages.authority.result`	string / null	Required	Saved result; null when this operation has no completed result.
`rows[].watch.check_status.stages.authority.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.check_status.stages.authority.refresh`	string	Required	values: `"automatic"`, `"with_check"`, `"not_refreshed"`, `"none"`
`rows[].watch.check_status.last_run`	object / null	Required
`rows[].watch.check_status.last_run.id`	string	Required	Resource identifier returned by the operation.
`rows[].watch.check_status.last_run.watch_id`	string	Required	Identifier returned by the related operation.
`rows[].watch.check_status.last_run.operation_key`	string	Required
`rows[].watch.check_status.last_run.state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: `"pending"`, `"running"`, `"completed"`, `"partial"`
`rows[].watch.check_status.last_run.source`	object	Required	additional fields rejected
`rows[].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"`
`rows[].watch.check_status.last_run.source.job_id`	string / null	Required	Identifier returned by the related operation.
`rows[].watch.check_status.last_run.source.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.check_status.last_run.source.result`	string / null	Required	Saved result; null when this operation has no completed result.
`rows[].watch.check_status.last_run.source.lane`	string / null	Required
`rows[].watch.check_status.last_run.source.last_crawl_at`	string / null	Optional
`rows[].watch.check_status.last_run.source.retrieved_at`	string / null	Optional
`rows[].watch.check_status.last_run.target`	object	Required	additional fields rejected
`rows[].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"`
`rows[].watch.check_status.last_run.target.job_id`	string / null	Required	Identifier returned by the related operation.
`rows[].watch.check_status.last_run.target.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.check_status.last_run.target.result`	string / null	Required	Saved result; null when this operation has no completed result.
`rows[].watch.check_status.last_run.target.lane`	string / null	Required
`rows[].watch.check_status.last_run.target.last_crawl_at`	string / null	Optional
`rows[].watch.check_status.last_run.target.retrieved_at`	string / null	Optional
`rows[].watch.check_status.last_run.classification`	object	Required	additional fields rejected
`rows[].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"`
`rows[].watch.check_status.last_run.classification.job_id`	string / null	Required	Identifier returned by the related operation.
`rows[].watch.check_status.last_run.classification.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.check_status.last_run.classification.result`	string / null	Required	Saved result; null when this operation has no completed result.
`rows[].watch.check_status.last_run.classification.lane`	string / null	Required
`rows[].watch.check_status.last_run.classification.last_crawl_at`	string / null	Optional
`rows[].watch.check_status.last_run.classification.retrieved_at`	string / null	Optional
`rows[].watch.check_status.last_run.google`	object	Required	additional fields rejected
`rows[].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"`
`rows[].watch.check_status.last_run.google.job_id`	string / null	Required	Identifier returned by the related operation.
`rows[].watch.check_status.last_run.google.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.check_status.last_run.google.result`	string / null	Required	Saved result; null when this operation has no completed result.
`rows[].watch.check_status.last_run.google.lane`	string / null	Required
`rows[].watch.check_status.last_run.google.last_crawl_at`	string / null	Optional
`rows[].watch.check_status.last_run.google.retrieved_at`	string / null	Optional
`rows[].watch.check_status.last_run.authority`	object	Required	additional fields rejected
`rows[].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"`
`rows[].watch.check_status.last_run.authority.job_id`	string / null	Required	Identifier returned by the related operation.
`rows[].watch.check_status.last_run.authority.reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`rows[].watch.check_status.last_run.authority.result`	string / null	Required	Saved result; null when this operation has no completed result.
`rows[].watch.check_status.last_run.authority.lane`	string / null	Required
`rows[].watch.check_status.last_run.authority.last_crawl_at`	string / null	Optional
`rows[].watch.check_status.last_run.authority.retrieved_at`	string / null	Optional
`rows[].watch.check_status.last_run.follow_up_required`	boolean	Required
`rows[].watch.check_status.last_run.created_at`	string	Required	UTC timestamp when the record was created.
`rows[].watch.check_status.last_run.updated_at`	string	Required	UTC timestamp of the last record update.
`rows[].watch.check_status.last_run.expires_at`	string	Required
`rows[].watch.check_status.last_run.expired`	boolean	Required
`rows[].watch.candidate_only`	number	Optional
`rows[].watch.created`	boolean	Optional	True when this request created the record; false when an existing record was reused.
`rows[].watch.detail`	string	Optional
`rows[].error`	object	Optional
`rows[].error.code`	string	Required
`rows[].error.message`	string	Required
`rows[].error.admission`	object	Optional	additional fields rejected
`rows[].error.admission.index`	integer	Required	minimum: `0`; maximum: `9007199254740991`
`rows[].error.admission.url`	string	Required
`rows[].error.admission.normalized_url`	string / null	Required
`rows[].error.admission.host`	string / null	Required
`rows[].error.admission.decision`	string	Required	values: `"admitted"`, `"rejected"`
`rows[].error.admission.reason`	string	Required	Recorded explanation; null when no explanation applies.
`rows[].error.admission.rule_kind`	string / null	Required
`rows[].error.admission.rule_id`	string / null	Required	Identifier returned by the related operation.
`rows[].error.admission.rule_value`	string / null	Required
`rows[].error.admission.cap`	object / null	Required
`rows[].error.admission.cap.limit`	integer	Required	maximum: `9007199254740991`; exclusiveMinimum: `0`
`rows[].error.admission.cap.used`	integer	Required	minimum: `0`; maximum: `9007199254740991`
`rows[].error.admission.subject_key`	string	Required
`rows[].error.details`	object	Optional
`rows[].error.details.reason`	string	Optional	Recorded explanation; null when no explanation applies.
`rows[].error.details.fields`	array	Optional
`rows[].error.details.issues`	array	Optional
`rows[].error.details.issues[].field`	string	Required
`rows[].error.details.issues[].problem`	string	Required
`rows[].error.details.issues[].reason`	string	Required	Recorded explanation; null when no explanation applies.
`rows[].error.details.issues[].message`	string	Required
`rows[].error.details.issues[].example`	any	Optional
`rows[].error.details.next`	string	Optional
`imported`	number	Required
`accepted`	number	Required
`created`	number	Required	Number of records created by this operation.
`existing`	number	Required
`failed`	number	Required

Download input schema · Download output schema

Errors and retries

This write is not annotated idempotent. After a timeout, inspect existing state before repeating it. 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/watches/import`	201	Remaining arguments go in a JSON object body.

Continue

list_link_watches 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

Example request

Returned result

Input fields

Validation and omitted values

Output fields

Errors and retries

HTTP resource routes

Continue

​Example request

​Returned result

​Input fields

​Validation and omitted values

​Output fields

​Errors and retries

​HTTP resource routes

​Continue

Example request

Returned result

Input fields

Validation and omitted values

Output fields

Errors and retries

HTTP resource routes

Continue