---
title: "Anchor one evidence item to one exact claim of the intent (objective, outcome, constraint, or edge case). Changes where the item backs, never whether it is reviewed: the item's tier is untouched."
method: POST
path: "/api/v1/intents/{id}/evidence/anchors"
tags: ["evidence"]
---

# Anchor one evidence item to one exact claim of the intent (objective, outcome, constraint, or edge case). Changes where the item backs, never whether it is reviewed: the item's tier is untouched.

`POST /api/v1/intents/{id}/evidence/anchors`

The row-locked anchor_evidence_to_intent RPC validates the live claim and commits its anchor, join row, and reverse link atomically, so concurrent writes cannot drop it or leave the relationship partially synchronized. Emits evidence_anchored (claim kind, tier, source claim_row) and, when newly linked, evidence_linked. Review with attribution (moving an unreviewed item to backing) is a separate, session-only action in the Claim Trust Loop; this endpoint never changes triage_status. Plan: .claude/plans/evidence-trust-contract.md (Claim Trust Loop, slice A).

## Path parameters

- `id` string, required

## Request body

- object
  - `evidenceId` string, required — UUID of an evidence item in this workspace (same product as the intent when both are set).
  - `anchorKey` string, required — One of the claim keys returned by GET /evidence: objective, outcome:<id>, constraint:<index>, edgeCase:<id>.

## Response `200`

Anchored (idempotent: an existing pair returns alreadyAnchored=true)

- object

## Other responses

- `400` — Invalid body
- `401` — Missing or invalid API key/session
- `403` — Lacks write scope
- `404` — Intent not found, CLAIM_NOT_FOUND (anchorKey names no claim on this intent), or EVIDENCE_NOT_FOUND
- `409` — EVIDENCE_EXCLUDED (archived or dismissed) or PRODUCT_MISMATCH
- `429` — Rate limited
- `500` — Anchor merge failed

## Changes

- **2026-09-04** `35441fda7ae7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pathmode/apis/pathmode-api/changes/api/v1/intents/:id/evidence/anchors/post.md)

---

[API](https://skmtc.dev/pathmode/apis/pathmode-api.md) · [All operations](https://skmtc.dev/pathmode/apis/pathmode-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pathmode/apis/pathmode-api/revisions/0f4a7b92b504?raw)