Confirm or reject one of a session's achievements
Owners, admins and the admins of the achievement's agent (achievement.review), signed in, who can also read its session; API keys are refused. confirm counts a needs_review achievement (review_state: confirmed); reject drops an auto or needs_review one from the count (rejected). A review is final: a later judgment never changes it, and a second review, or confirming an auto one, is 409 REVISION_CONFLICT with details.reason_code: not_reviewable. note is kept on the achievement as review_note, not in the receipt. Writes a review_achievement receipt naming the achievement and its new state. An achievement of another owner, or one a later judgment replaced, is 404.
Auth: cookie session only; no scope. Idempotency-Key: ignored.
cookieSession__Host-werft_session<token>For the web console: the browser session cookie set by POST /v1/auth/login. It holds the scopes of the user's workspace role (owner: all; admin and member: all but sessions:recover). Requests other than GET must also send X-Requested-With: werft-web.
id*stringThe achievement's id.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidX-Requested-With?"werft-web"Required with a cookie session: the literal werft-web.
"werft-web"application/json- body
action*string"confirm""reject"note?string1 <= length <= 500The achievement as reviewed, and the receipt.
application/json- response
achievement*receipt_id*string^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidcurl -X POST 'https://example.com/v1/achievements/497f6eca-6276-4993-bfeb-53cbbbba6f08/review' \ -H 'Content-Type: application/json' \ -d '{ "action": "confirm"}'{ "achievement": { "id": "0b1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e", "session_id": "0f8b6a52-3d1e-4c7a-9b2f-5e6d7c8a9b01", "agent_id": null, "agent_release_id": null, "rule_id": "7d3a4e5f-6b7c-4d8e-8f9a-1b2c3d4e5f60", "rule_family_id": "8e4b5f6a-7c8d-4e9f-9a0b-2c3d4e5f6a71", "type_id": "9f5c6a7b-8d9e-4f0a-8b1c-3d4e5f6a7b82", "title": "out/payment-retry.md", "link": "/sessions/0f8b6a52-3d1e-4c7a-9b2f-5e6d7c8a9b01", "evidence_kind": "out_file", "evidence_id": "out/payment-retry.md", "payload": { "path": "out/payment-retry.md", "size": 4198 }, "judge": "always", "rule_title": "Design document", "rule_version": 3, "type_key": "document", "probability": null, "threshold": null, "rejudged_after_merge": false, "judgment_id": "1c2d3e4f-5a6b-4c7d-9e8f-0a1b2c3d4e5f", "review_state": "confirmed", "reviewed_by": "3e7f1a90-5c2d-4b8e-8f61-2a9d0c4b7e35", "reviewed_at": "2026-10-30T10:02:00.000Z", "review_note": null, "created_at": "2026-10-30T09:42:10.000Z" }, "receipt_id": "c4a1e9d2-7b3f-4e8a-a6c5-1d2e3f4a5b6c"}