update_link_watch

Remaining arguments go in a JSON object body.

patch/v1/watches/{watchId}

Request

  • Base URL: https://app.agentlinkops.com
  • URL: https://app.agentlinkops.com/v1/watches/{watchId}
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

watchIdstring required

watch ID from create/list.

Headers

X-Workspace-IDstring

Required when using a Clerk human session. With an API key, omit this header or supply its bound workspace.

Request body

status'active' | 'paused'

Lifecycle status, separate from observed state.

archivedboolean

archived; see schema.

cadenceSecondsinteger

Check interval: 3600 to 2592000 seconds.

expectedAnchorstring nullable

Expected anchor text; null clears expectation.

expectedRelstring[] nullable

Expected rel tokens; null clears expectation.

localReferencestring

Customer reference for a local ledger entry.

Response

Remaining arguments go in a JSON object body.

idstring required

Resource identifier returned by the operation.

workspace_idstring required

Workspace that owns this record.

project_idstring required

Project that owns this record.

status'active' | 'paused' required

Resource lifecycle status.

cadence_secondsnumber required
statestring required

Saved lifecycle or evidence state, as enumerated for this record.

created_atstring required

UTC timestamp when the record was created.

updated_atstring required

UTC timestamp of the last record update.

last_attempt_atstring nullable required
last_success_atstring nullable required
last_observation_idstring nullable required
next_check_atstring nullable required
overdue_reasonstring nullable required
google_crawlableboolean nullable

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_reasonstring nullable

Recorded Googlebot robots permission or why that permission is unknown. Separate from permission for AgentLinkOps monitoring.

robots_rulestring nullable

Publisher robots.txt path rule supporting the current Googlebot decision, or null when no matching rule was observed.

noindexboolean nullable

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_nofollowboolean nullable

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_relstring[] nullable

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_reasonstring nullable

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_atstring nullable

Original timestamp of the most recent complete link presence or absence check. It stays unchanged after a blocked or incomplete check.

category_contract'link-category-v1'

Version of the shared table, API and export category projection.

source_urlstring required

Publisher page URL recorded in this evidence.

target_urlstring required

Destination URL recorded in this evidence.

target_scopestring required
expected_anchorstring nullable required
expected_relstring[] nullable required
local_referencestring nullable required

Customer reference for joining this record to a local ledger entry.

last_successful_observation_idstring nullable required
history_compacted_beforestring nullable
archived_atstring nullable
provider_metrics_retrieved_atstring nullable
provider_metrics_data_modestring
createdboolean

True when this request created the record; false when an existing record was reused.

detailstring
type'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' nullable

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'person' | 'model' | 'null' nullable

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_revisioninteger

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.

disavow'active' | 'proposed' | 'null' nullable

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.

Changes

No recorded changes to this operation across all 1 revision of this API.