← Back to Tokens & Audit
Tokens & Audit

What is a signed decision receipt?

A signed decision receipt is a single-use, HMAC-signed proof of what oakallow decided about a tool call.

Every permission check on an approved tool returns a receipt inline, in the same call. For every verdict, not just allowed. There is no separate step: the check that resolves the decision also signs it. The signature binds the verdict and the exact request (tool, tenant, resource, method, parameters), and the receipt carries a nonce that can only be used once, preventing replay.

A receipt is cryptographic evidence that
  • oakallow evaluated this exact request and what it decided (allowed, requires_approval, or disabled)
  • The specific tool and parameters were bound to the decision
  • The receipt was not reused from a previous call

A disabled receipt is just as real as an allowed one: it is the proof oakallow blocked the action.

(The standalone /v1/tokens/mint endpoint still exists for integrations built before inline signing, but it is no longer required. The permission check signs every decision on its own.)

Next How does audit logging work?

More in Tokens & Audit