list_link_watches

Read arguments go in query parameters. state accepts rechecking for couldnt_check records whose current verification state is suspected_missing, or cant_reach for the remaining couldnt_check records. These filters partition couldnt_check; they neither queue a check nor confirm loss. Returned rows retain their verification state. Category filters use categoryScope=shown by default; page_role selects occurrence roles. assessmentScope=current is the default for AI evidence. With a supplied category and categoryScope=shown, assessmentScope=previous selects AI evidence that is no longer current and excludes team choices. Filters apply before pagination; reading starts no classification.

get/v1/watches

Request

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

Query parameters

cursorstring

Opaque list cursor; omit initially.

limitinteger

Page/report row cap; see bounds.

browseboolean

Server-sorted authorized saved rows; omit for legacy paging.

sortstring

Allowlisted saved-field identifier.

order'asc' | 'desc'

Sort direction; stable ID ties, nulls last.

qstring

Saved-record text filter; no discovery.

table_filtersstring

JSON-encoded array of up to 12 filters. Each filter has column (1 to 80 characters), operator (contains, is, is_not or empty), and value (at most 500 characters).

projectIdstring

project ID from create/list.

statestring

Resource state or saved-observation filter.

status'active' | 'paused'

Lifecycle status, separate from observed state.

archived'exclude' | 'only' | 'include'

exclude hides removed links; only lists removed links; include returns both.

disavowed'yes' | 'suggested' | 'no'

disavowed; see schema.

disavowRulestring

disavow rule; see schema.

typestring

Legacy saved type, including model cache. Use category for displayed type.

tagstring

tag; see schema.

category'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' | 'none' | 'mixed' | 'cleared'

none=unknown or deliberately cleared; mixed=multiple assessed page roles.

categoryScope'shown' | 'page_role'

shown (default)=displayed category; page_role=any assessed occurrence role.

assessmentScope'current' | 'previous'

current (default) excludes previous assessments; previous selects them.

categoryState'cleared' | 'not_started' | 'pending' | 'classifier_unavailable' | 'classifier_failed' | 'page_unavailable' | 'partial' | 'previous'

Reason/coverage state; combines with category.

include'summary' | 'detail'

include; see schema.

format'concise' | 'detailed'

Concise: decisions/next calls/evidence states; detailed: all. MCP/code default concise, REST/CLI detailed; defaults_applied records defaults.

Headers

X-Workspace-IDstring

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

Response

Read arguments go in query parameters. state accepts rechecking for couldnt_check records whose current verification state is suspected_missing, or cant_reach for the remaining couldnt_check records. These filters partition couldnt_check; they neither queue a check nor confirm loss. Returned rows retain their verification state. Category filters use categoryScope=shown by default; page_role selects occurrence roles. assessmentScope=current is the default for AI evidence. With a supplied category and categoryScope=shown, assessmentScope=previous selects AI evidence that is no longer current and excludes team choices. Filters apply before pagination; reading starts no classification.

totalinteger nullable
has_moreboolean

True when another page is available.

next_cursorstring nullable required

Opaque continuation for the same listing; null means no further page.

Changes

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