POST /v1/domains/{domain}/renew — Renew a Domain Name
POST /v1/domains//renew — Extend a domain’s registration by 1–10 years. Credits are debited atomically at the stored renewal rate.
Use this endpoint to extend the registration period of a domain you own. You can add between 1 and 10 years in a single request, and credits are debited atomically at the renewal rate stored for your workspace at the time of the request. The new expiry date is always calculated from the later of the current expiry or the current date, so renewing early never causes you to lose time on your existing registration.
The number of years to extend the domain’s registration by. Must be between 1 and 10. Defaults to 1 if omitted.
Renewal extends the expiry from the later of “now” or the current expiry date. If your domain expires on 2027-01-04 and you renew today, you get a full year added on top of the existing expiry — you don’t lose any time you’ve already paid for.
Credits are debited immediately when the renewal succeeds. Renewals cannot be reversed once the updated registration period has been confirmed with the registry.