Skip to content

Promo codes

View Markdown

A promo code adds a credit grant to your org. Redeem it from the CLI or from Usage & billing → Credits → Redeem code in the console:

Terminal window
$ nodus billing redeem LAUNCH25
Redeemed ****CH25: $25.00 of credit, expires 2026-11-30.

Codes are not case-sensitive, and spaces around them are ignored. Redeeming needs the billing:write permission. The response shows the code masked to its last four characters; Nodus stores only a keyed digest of each code.

Error Meaning
404 NotFound The code does not exist, or it has been withdrawn
410 Expired The code’s last redemption date has passed
409 Conflict Your org has already redeemed this code, or the code has been fully redeemed
429 TooManyRequests More than 5 attempts in a minute; wait a minute and try again

Retrying a redemption with the same Idempotency-Key returns the first result and never adds credit twice. The CLI and console set the key for you.

A promo grant expires on the date the code sets, counted from when you redeem it. Codes without one never expire.