Agent Receipts

Promote a draft receipt to active (explicit review gate)

Transitions a draft receipt to active. Requires promotedBy identity. Validates the receipt fully before promotion. Optionally auto-deprecates a superseded active receipt. Requires _rev for CAS conflict protection. Caller must have full-access scope or ROLE_RECEIPT_PROMOTER (#289).

post/api/agent-receipts/:id/promote

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/agent-receipts/:id/promote
  • Auth: none declared

Path parameters

idstring required
Example:vnb-lookup-v2

Query parameters

tokenstring

Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.

Request body

promotedBystring required

Identity of the reviewer who approved promotion.

changeReasonstring
supersedesstring

Optional receiptId of an active receipt to auto-deprecate on promotion. Falls back to supersedes field stored on the draft.

_revstring nullable

CAS revision token. Prevents concurrent promotion race conditions.

tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "promotedBy": "admin@example.com"
}

Response

Successful response

object required

Changes

No recorded changes to this operation across all 2 revisions of this API.