Agent Receipts

Propose a new draft receipt (governed learning loop)

Creates a receipt in draft status only. Chat and automated flows must use this path instead of create. The receipt is pending review and must be explicitly promoted before becoming active.

post/api/agent-receipts/propose

Request

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

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

receiptIdstring required
titlestring required
descriptionstring required
domainstring required
tagsstring[]
matchingobject required
requiredInputsstring[]
toolPlanobject required
creatorIdstring nullable

Identity of the creator (user id, agent name, etc).

creatorSource'chat' | 'admin' | 'api' | 'seed'

Origin of the proposal. Chat-originated proposals must use chat.

changeReasonstring

Optional human-readable reason for this proposal.

supersedesstring

Optional receiptId of an active receipt this draft intends to supersede upon promotion.

tokenstring

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

Example request

{
  "receiptId": "vnb-lookup-v2"
}

Response

Successful response

object required

Changes

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