Finalize a claimed downstream commit attempt

Deprecated alias of POST /v1/authority/grants/{grantId}/receipts: the same handler.

Records COMMITTED, FAILED, or INDETERMINATE. INDETERMINATE effects must be reconciled and are never safe for automatic retry. A COMMITTED claim proves an attempt was finalized, but an effect is confirmed only when digest-bound effect_evidence with status CONFIRMED is accepted. If the signed grant expires after a successful claim, finalization may continue only while the exact persisted claim token, nonce, correlation, and database claim lease remain valid. An expired unclaimed grant is never execution-eligible. A finalize request at or after the database-clock lease boundary fails closed and atomically records the claim as INDETERMINATE.

A verifying provider's signed effect receipt (Verifying Provider Profile, VP-3) may accompany the finalization as effect_receipt. It is verified against the organisation's registered provider keys and recorded in the commit evidence as presented, verified or not; it is never a reason to refuse the finalization. When the grant named the effect it expected and the verified receipt carries an effect digest, the receipt is also read as SIGNED_RECEIPT effect evidence, and confirms the effect only when the digests agree and the outcome is COMMITTED. An explicit effect_evidence takes precedence.

post/v1/execution/finalize-token

Request

  • Base URL: https://api.decionis.com
  • URL: https://api.decionis.com/v1/execution/finalize-token
  • Auth: HTTP bearer

Request body

execution_tokenstring required
claim_tokenstring required
outcome'COMMITTED' | 'FAILED' | 'INDETERMINATE' required
commit_correlation_idstring required
downstream_evidenceobject

Free-form legacy evidence; never interpreted as effect confirmation.

effect_receiptstring

A verifying provider's effect receipt, forwarded by the executor exactly as the provider returned it: a compact EdDSA JWS whose protected header typ is decionis-effect-receipt+jwt and whose payload is EffectReceiptClaims. Verified against the organisation's registered provider keys and recorded whatever the verdict; never a reason to refuse the finalization.

Response

Claim finalized and commit evidence recorded or queued for recovery

finalizedboolean required
outcome'COMMITTED' | 'FAILED' | 'INDETERMINATE'
evidence_recordedboolean

Compatibility field reporting immediate Decision Chain acknowledgement.

evidence_durably_queuedboolean

True when commit evidence was persisted transactionally with the terminal claim state, including lease-expiry INDETERMINATE.

decision_chain_evidence_recordedboolean

True when the Protocol Decision Chain had already acknowledged the commit evidence when this response was formed; false is delivered asynchronously from the durable outbox.

effect_evidence_recordedboolean
effect_confirmation'CONFIRMED' | 'UNCONFIRMED'
reason_codesstring[] required

Changes

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