Decide a knowledge review item
Resolve one pending knowledge review item with a grade, merge, verification or dismissal and a recorded note, as a steward does in Console. Requires knowledge:manage.
v2 compatibility notes
POST /api/v2/knowledge/decideReview with { id, decision, note } decides one pending item in the knowledge review queue, as a steward decides it in the Console review queue. It needs knowledge:manage and answers 200 with { itemId, status }: approved for a grade, merge or verification, rejected for a dismissal.
A holder of knowledge:manage decides an item with this route (MCP forge_decide_knowledge_review), or a person in Console through the item’s handoff link. An authorized call is a steward decision: it is recorded with the credential’s attribution, a Personal key as its owner, with the key named on the audit event (via: "personal_key", apiKeyId); an External App as external-app:<id>, with the people who granted its access; a platform key as platform-key:<id>. The stamp is never returned.
400 bad_request
400 bad_request
Idempotency-Key.403 permission_denied or forbidden
403 permission_denied or forbidden
permission_denied: the credential lacks knowledge:manage. forbidden: the item’s case, or a case the decision writes, moved out of the credential’s readable namespaces; or a verify where the credential lacks knowledge:manage at the case’s home. Each refusal is recorded.404 resource_missing
404 resource_missing
409 invalid_state or conflict
409 invalid_state or conflict
invalid_state: the item is already resolved. conflict: the merge was refused (the message gives the reason, and nothing is written); the verification occurrence the item named has changed; or a proven grade would promote a pending revision whose conflict item, or whose live case’s contest, is still undecided (decide that item first). The Idempotency-Key answers idempotency_key_in_flight, idempotency_outcome_unknown and idempotency_result_unavailable are also 409.Idempotency-Key to retry safely. A repeat returns the recorded response only while the credential still holds knowledge:manage and knowledge:read and can still see the item; otherwise it answers 403 for a missing knowledge:read, or the non-disclosing 409 idempotency_result_unavailable. See Knowledge curation replay.Authorizations
Headers
1–255 printable ASCII characters. A repeat with the same key and request never runs the write again, a 5xx included. It returns the first response (Idempotency-Replayed: true) only when the route's current authorization policy permits disclosure; otherwise 409 idempotency_result_unavailable. Honoured for External App JWTs and platform and MCP keys; an External App's static companion key is not protected.
1 - 255Body
A steward's decision on one pending review item, and why (1–500 characters, recorded with it). Each kind allows its own decisions: approval — grade proven or dismiss; contested — grade proven, provisional or retired, or dismiss; conflict — grade the case or a related case provisional or retired, or dismiss; duplicate — merge the loser into the survivor, or dismiss; stale — grade retired, or dismiss; verification_due — verify the case, or dismiss.

