Link monitoring and evidence

Locate link

Shared command transport. All logical arguments in JSON; no query or Idempotency-Key header. See canonical operation reference.

post/v1/commands/locate_link

Request

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

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

observationIdstring required

ID of a saved observation; this does not fetch a new publisher page.

Response

Command result, including queued admission.

vnumber required
evidence_locatorstring nullable required

Stable reference naming this observation, of the form agentlinkops:evidence/version/link/hosted/id; it resolves to the observation itself and is never session-bound.

observation_idstring nullable required
statestring nullable required

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

reasonstring nullable required

Recorded explanation; null when no explanation applies.

source_urlstring nullable required

Publisher page URL recorded in this evidence.

final_urlstring nullable required
target_urlstring nullable required

Destination URL recorded in this evidence.

observed_atstring nullable required

UTC timestamp of the observation used here.

checker_versionstring nullable required
evidence_methodstring required
renderedboolean required
occurrence_countnumber required
truncatedboolean required

Changes

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