Interactions

Append an agent-reported Fulfillment status for an exact approved proposal.

Requires ownership or explicit fulfillment authority, exact Decision/revision/action/fingerprint binding, and Idempotency-Key. Later reports correct history without rewriting it.

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

Request

  • Base URL: https://commentary.dev
  • URL: https://commentary.dev/api/v1/interactions/{interactionId}/fulfillment
  • Auth: HTTP bearer

Path parameters

interactionIdstring required

Opaque Interaction id.

Headers

Idempotency-Keystring required
X-Correlation-Idstring
X-Commentary-Workspace-Idstring

Must match the credential workspace. This header cannot widen grant authority.

Request body

decisionIdstring required
revisionIdstring required
actionIdstring required
proposalFingerprintstring required
status'received' | 'started' | 'completed' | 'failed' | 'unknown' required
evidenceobject nullable

Sanitized JSON evidence, at most 8 KiB; credentials and raw logs are forbidden.

Response

Successful response.

object required

Changes

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