Skip to navigation

Mint a public badge token for your tenant

API key required. Mints a badge token (writ_badge_...) for the caller’s tenant and returns the badge image URL plus a ready-to-paste Markdown snippet. Embed the snippet in your README: the badge renders a live count of your tenant’s gated writes over the trailing 30 days, straight from your audit log.

The token is public by design — it lives in your README image URL — and grants nothing: it cannot be used as an API key (see the 401 below). It maps to your tenant server-side, so the badge image never leaks tenant IDs, keys, or receipt contents. The token is shown exactly once; store it — you need it to revoke the badge. Optional label (max 40 chars, [A-Za-z0-9 _.-]) is stored for your own bookkeeping and never rendered.

Request

This endpoint expects an object.
labelstringOptional

Optional private label for this badge token (not rendered on the badge).

Response

Badge token, image URL, and embed snippet.

Errors

401
Unauthorized Error