Update link watch

​

Example request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_link_watch",
    "arguments": {
      "watchId": "watch_example"
    }
  }
}

agentlinkops call update_link_watch --args '{"watchId":"watch_example"}'

curl --fail-with-body https://app.agentlinkops.com/v1/commands/update_link_watch \
  -H "Authorization: Bearer $AGENTLINKOPS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"watchId":"watch_example"}'

​

Returned result

{
  "workspace_id": "ws_example",
  "project_id": "pr_example",
  "status": "paused",
  "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",
  "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": 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
  }
}

​

Input fields

• watchId (string, optional): watch ID from create/list. minLength: 1; maxLength: 200
• watchIds (array, optional): minItems: 1; maxItems: 100
• intent (string, optional): values: "prospect", "earned", "retired"
• outreachStatus (string / null, optional).
• lastContactedAt (string / null, optional).
• campaign (string / null, optional).
• expectedPipeline (object, optional): Single-watch outreach fields only. Full saved pipeline from get_link_watch; changed values refuse with WATCH_PIPELINE_CONFLICT. additional fields rejected
• status (string, optional): Lifecycle status, separate from observed state. values: "active", "paused"
• archived (boolean, optional).
• cadenceSeconds (integer, optional): Check interval in seconds; see bounds. minimum: 3600; maximum: 2592000
• expectedAnchor (string / null, optional): Expected anchor; null clears.
• expectedRel (array / null, optional): Expected rel tokens; null clears.
• localReference (string, optional): Local ledger reference. maxLength: 200

​

Validation and omitted values

​

Output fields

• intent (string, optional).
• outreachStatus (string / null, optional).
• lastContactedAt (string / null, optional).
• campaign (string / null, optional).
• id (string, required): Resource identifier returned by the operation.
• workspace_id (string, required): Workspace that owns this record.
• project_id (string, required): Project that owns this record.
• status (string, required): Resource lifecycle status.
• cadence_seconds (number, required): Configured check interval in seconds. Scheduling and admission can delay completion.
• state (string, required): Saved lifecycle or evidence state, as enumerated for this record.
• observation_state (object, required): Saved observation state. Before the first check, this object can be empty.
• created_at (string, required): UTC timestamp when the record was created.
• updated_at (string, required): UTC timestamp of the last record update.
• last_attempt_at (string / null, required): UTC timestamp of the latest saved attempt, including an inconclusive attempt; null before any attempt.
• 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.
• last_observation_id (string / null, required): Identifier returned by the related operation.
• 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.
• overdue_reason (string / null, required): Recorded scheduling or admission delay; null when no delay reason is saved.
• 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.
• google_crawl_reason (string / null, optional): Recorded Googlebot robots permission or why that permission is unknown. Separate from permission for AgentLinkOps monitoring.
• robots_rule (string / null, optional): Publisher robots.txt path rule supporting the current Googlebot decision, or null when no matching rule was observed.
• 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.
• 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.
• 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.
• 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.
• 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.
• 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.
• category_contract (string, optional): Version of the shared table, API and export category projection.
• 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.
• 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.
• 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.
• source_url (string, required): Publisher page URL recorded in this evidence.
• target_url (string, required): Destination URL recorded in this evidence.
• target_scope (string, required).
• expected_anchor (string / null, required).
• expected_rel (array / null, required).
• local_reference (string / null, required): Customer reference for joining this record to a local ledger entry.
• last_successful_observation_id (string / null, required): Identifier returned by the related operation.
• 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.
• archived_at (string / null, optional).
• provider_metrics (object / object / object, optional).
• provider_metrics_retrieved_at (string / null, optional).
• provider_metrics_data_mode (string, optional).
• initial_check (object, optional).
• check_operation (object, optional).
• check_status (object / null, optional).
• candidate_only (number, optional).
• created (boolean, optional): True when this request created the record; false when an existing record was reused.
• detail (string, optional).
• 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.
• 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.
• 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.
• 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.
• 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.
• rows (array, required).
• updated (number, required).
• failed (number, required).

​

Errors and retries

​

HTTP resource routes

​

Continue