Interactions

Record one immutable human Decision against an exact proposal action.

Requires exact revisionId, actionId, proposal fingerprint, current strong If-Match, and Idempotency-Key. The first valid result is immutable; replay never retargets a later revision. A Decision is intent, not Fulfillment or execution evidence.

post/api/v1/interactions/{interactionId}/decisions

Request

  • Base URL: https://commentary.dev
  • URL: https://commentary.dev/api/v1/interactions/{interactionId}/decisions
  • Auth: API key in cookie commentary_session

Path parameters

interactionIdstring required

Opaque Interaction id.

Headers

If-Matchstring required
Idempotency-Keystring required

Request body

revisionIdstring required
actionIdstring required
proposalFingerprintstring required
outcome'approve' | 'reject' | 'abstain' | 'conflict' | 'acknowledge' | 'choose' | 'answer' | 'comment' | 'request_revision' | 'snooze' required
consequenceobject nullable

Response

Successful response.

Changes

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