Get placement review history

get_placement_review_history Read dated model suggestions, corrections, undo actions and concerns for one retained physical occurrence. Pages remain bound to that capture and a frozen revision. Missing or expired history does not establish that no earlier changes occurred. Makes no source fetch, write or model call.

Development preview. This command is absent from the verified deployed bundle. Use a matching development environment.

Access	Behavior
`watches:read`	Reads saved data

This read does not start a verification job.

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": "get_placement_review_history",
    "arguments": {
      "watchId": "watch_example",
      "occurrenceId": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
      "captureId": "capture_example",
      "evidenceHash": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
      "limit": 20
    }
  }
}

agentlinkops call get_placement_review_history --args '{"watchId":"watch_example","occurrenceId":"sha256:1111111111111111111111111111111111111111111111111111111111111111","captureId":"capture_example","evidenceHash":"sha256:2222222222222222222222222222222222222222222222222222222222222222","limit":20}'

curl "$AGENTLINKOPS_API_URL/v1/commands/get_placement_review_history" \
  -H "Authorization: Bearer $AGENTLINKOPS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"watchId":"watch_example","occurrenceId":"sha256:1111111111111111111111111111111111111111111111111111111111111111","captureId":"capture_example","evidenceHash":"sha256:2222222222222222222222222222222222222222222222222222222222222222","limit":20}'

Returned result

Illustrative data validated against the documented response schema. IDs and dates are examples, not a live account capture. MCP returns this data in structuredContent and in a text content block; generic HTTP and CLI return the JSON result directly.

{
  "schemaVersion": 1,
  "historyMeaning": "Only retained reviews for this exact occurrence and capture are included.",
  "binding": {
    "workspaceId": "workspace_example",
    "projectId": "project_example",
    "watchId": "watch_example",
    "occurrenceId": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
    "captureId": "capture_example",
    "evidenceHash": "sha256:2222222222222222222222222222222222222222222222222222222222222222"
  },
  "asOfRevision": 1,
  "readAt": "2026-10-08T20:00:00.000Z",
  "items": [],
  "nextCursor": null,
  "hasMore": false,
  "coverage": {
    "status": "retained",
    "reason": "exact_capture_only",
    "meaning": "Missing history does not establish that no earlier changes occurred."
  }
}

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
`watchId`	string	Required	Identifier of the watch returned by its create or list operation. minLength: 1; maxLength: 200
`occurrenceId`	string	Required	Identifier of the occurrence returned by its create or list operation. pattern: “^sha256:[a-f0-9]{64}$“
`captureId`	string	Required	Identifier of the capture returned by its create or list operation. minLength: 1; maxLength: 200
`evidenceHash`	string	Required	The evidence hash value; allowed values and bounds are specified in this schema. pattern: “^sha256:[a-f0-9]{64}$“
`limit`	integer	Optional	Maximum rows in this page or bounded report; subject to the schema maximum. minimum: 1; maximum: 50; default: 20
`cursor`	string	Optional	Opaque continuation returned by this same listing; omit for the first page. minLength: 1; maxLength: 2048

Validation and omitted values

Reads only retained suggestions, corrections, undo actions and concerns for the exact occurrence and capture. Original classification and later publication dates remain distinct. Pagination freezes a project revision and binds the current credential and evidence. Refresh to include later events. Missing or expired history does not prove that no earlier review occurred. Returns no source passages or provider payloads. Reading neither changes a review nor makes a source fetch or model call.

Defaults when omitted

Field	Default
`limit`	`20`

Output fields

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

schemaVersion (number, required): must equal 1
historyMeaning (string, required): minLength: 1; maxLength: 1000
binding (object, required): additional fields rejected
asOfRevision (integer, required): minimum: 0; maximum: 9007199254740991
readAt (string, required): format: “date-time”; pattern: ”^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$”
items (array, required): Records in this bounded page. maxItems: 50
nextCursor (string / null, required).
hasMore (boolean, required).
coverage (object, required): Dataset scope and completeness, including limits on what these results establish. additional fields rejected

All fields and nested objects

Field	Type	Presence	Meaning and constraints
`schemaVersion`	number	Required	must equal 1
`historyMeaning`	string	Required	minLength: 1; maxLength: 1000
`binding`	object	Required	additional fields rejected
`binding.workspaceId`	string	Required	Identifier returned by the related operation. minLength: 1; maxLength: 200
`binding.projectId`	string	Required	Identifier returned by the related operation. minLength: 1; maxLength: 200
`binding.watchId`	string	Required	Identifier returned by the related operation. minLength: 1; maxLength: 200
`binding.occurrenceId`	string	Required	Identifier returned by the related operation. pattern: “^sha256:[a-f0-9]{64}$“
`binding.captureId`	string	Required	Identifier returned by the related operation. minLength: 1; maxLength: 200
`binding.evidenceHash`	string	Required	pattern: “^sha256:[a-f0-9]{64}$“
`asOfRevision`	integer	Required	minimum: 0; maximum: 9007199254740991
`readAt`	string	Required	format: “date-time”; pattern: ”^(?:(?:\d\d[2468][048]\|\d\d[13579][26]\|\d\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\d\|30)\|(?:02)-(?:0[1-9]\|1\d\|2[0-8])))T(?:(?:[01]\d\|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$“
`items`	array	Required	Records in this bounded page. maxItems: 50
`items[].id`	string	Required	Resource identifier returned by the operation. minLength: 1; maxLength: 240
`items[].kind`	string	Required	values: “model_receipt”, “correction”, “revocation”, “concern”
`items[].revision`	integer	Required	Optimistic concurrency revision; supply it as expectedRevision on the next write. minimum: 0; maximum: 9007199254740991
`items[].occurredAt`	string	Required	format: “date-time”; pattern: ”^(?:(?:\d\d[2468][048]\|\d\d[13579][26]\|\d\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\d\|30)\|(?:02)-(?:0[1-9]\|1\d\|2[0-8])))T(?:(?:[01]\d\|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$“
`items[].recordedAt`	string	Required	format: “date-time”; pattern: ”^(?:(?:\d\d[2468][048]\|\d\d[13579][26]\|\d\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\d\|30)\|(?:02)-(?:0[1-9]\|1\d\|2[0-8])))T(?:(?:[01]\d\|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$“
`items[].actorId`	string / null	Required	Identifier returned by the related operation.
`items[].axis`	string / null	Required
`items[].value`	string / null	Required
`items[].state`	string / null	Required	Saved lifecycle or evidence state, as enumerated for this record.
`items[].reason`	string / null	Required	Recorded explanation; null when no explanation applies.
`items[].receiptId`	string / null	Required	Identifier returned by the related operation.
`items[].axes`	array	Optional	minItems: 1; maxItems: 6
`items[].axes[].axis`	string	Required	values: “page_surface”, “link_role”, “region_inferred”, “relevance”, “risk_cues”, “acquisition”
`items[].axes[].value`	string / null	Required
`items[].axes[].state`	string	Required	Saved lifecycle or evidence state, as enumerated for this record. values: “accepted_manual”, “accepted_auto”, “suggested”, “superseded”, “insufficient_evidence”, “not_evaluated”
`items[].axes[].basis`	string	Required	values: “model”, “rule”, “manual”, “attributed”
`items[].policy`	object	Optional	additional fields rejected
`items[].policy.taxonomyVersion`	string	Required	minLength: 1; maxLength: 200
`items[].policy.rubricVersion`	string	Required	minLength: 1; maxLength: 200
`items[].policy.extractorVersion`	string	Required	minLength: 1; maxLength: 200
`items[].policy.privacyRevision`	string	Required	minLength: 1; maxLength: 200
`nextCursor`	string / null	Required
`hasMore`	boolean	Required
`coverage`	object	Required	Dataset scope and completeness, including limits on what these results establish. additional fields rejected
`coverage.status`	string	Required	Resource lifecycle status. values: “retained”, “expired”, “unavailable”
`coverage.reason`	string	Required	Recorded explanation; null when no explanation applies. minLength: 1; maxLength: 200
`coverage.meaning`	string	Required	minLength: 1; maxLength: 1000

Download input schema · Download output schema

Errors and retries

The command is annotated idempotent. Reuse an accepted idempotency key when the input provides one; changing the payload under a reused key can conflict. Operation-specific errors include CLASSIFICATION_HISTORY_INVALID_CURSOR, CLASSIFICATION_HISTORY_UNAVAILABLE, CLASSIFICATION_ACCESS_DENIED. 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
`GET /v1/watches/{watchId}/classification/history`	200	Reads retained review history for one exact occurrence and capture. Pages bind a frozen revision. Expired or missing history does not prove that no earlier changes occurred. Makes no model request or write.

Continue

get_placement_context Follow the related workflow, inspect capability status, or return to the command index.

Overview

MCP, CLI and API commands

CLI client

HTTP and events

Optional local workflows

Get placement review history

Example request

Returned result

Input fields

Validation and omitted values

Defaults when omitted

Output fields

Errors and retries

HTTP resource routes

Continue

​Example request

​Returned result

​Input fields

​Validation and omitted values

​Defaults when omitted

​Output fields

​Errors and retries

​HTTP resource routes

​Continue

Example request

Returned result

Input fields

Validation and omitted values

Defaults when omitted

Output fields

Errors and retries

HTTP resource routes

Continue