Vouchers

Mint a starter voucher (web page only)

Not an agent operation. This exists so a page on run402.com can hand a human a promo code to paste into an agent's prompt. Agents call POST /vouchers/v1/redemptions with a code they were given; they have no reason to mint one.

Unauthenticated and rate-limited per IP. The amount, expiry, and issuing account are server-side constants — nothing in the request body can change what a voucher is worth.

context is an opaque JSON object stored verbatim and never interpreted by the platform, in the spirit of a metadata field. It lets whoever operates the page correlate a minted code back to where it came from; the gateway neither reads nor reports any field inside it.

Returns 503 when no account is configured for anonymous minting, so a caller can fail open to a codeless prompt rather than showing an error.

post/vouchers/v1/mints

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/vouchers/v1/mints
  • Auth: none required

Request body

contextobject

Opaque caller-defined metadata, at most 4 KB serialized.

Response

Voucher minted

codestring
amount_usd_microsinteger
expires_atstring date-time

Example response

{
  "code": "R402-K8F3-Q2W9",
  "amount_usd_micros": 1000000
}

Changes

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