---
title: "Changes to Renew a domain"
method: POST
path: "/{account}/registrar/domains/{domain}/renewals"
---

# Changes to Renew a domain

`POST /{account}/registrar/domains/{domain}/renewals`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 57 revisions.

- **2026-09-17** (v2) `079e0a7250a7`: 1 info
- **2025-07-11** (v2) `06780be0ef17`: 1 breaking, 9 info
- **2023-08-29** (v2) `e3e181e43246`: 1 info
- **2023-07-18** (v2) `c8591dcf8c29`: 9 breaking, 2 info

## Changes

- **2026-09-17** (v2) `079e0a7250a7`: 1 info
  - api operation id `domainRenew` removed and replaced with `renewDomain`
- **2025-07-11** (v2) `06780be0ef17`: 1 breaking, 9 info
  - the request property `period` became required
  - the response property `data` became required for the status `201`
  - the response property `data/created_at` became required for the status `201`
  - the response property `data/domain_id` became required for the status `201`
  - the response property `data/id` became required for the status `201`
  - the response property `data/period` became required for the status `201`
  - the response property `data/state` became required for the status `201`
  - the response property `data/updated_at` became required for the status `201`
  - the response property `errors` became required for the status `400`
  - the response property `message` became required for the status `400`
- **2023-08-29** (v2) `e3e181e43246`: 1 info
  - api tag `registrar` removed
- **2023-07-18** (v2) `c8591dcf8c29`: 9 breaking, 2 info
  - the response property `data` became optional for the status `201`
  - the response property `data/created_at` became optional for the status `201`
  - the response property `data/domain_id` became optional for the status `201`
  - the response property `data/id` became optional for the status `201`
  - the response property `data/period` became optional for the status `201`
  - the response property `data/state` became optional for the status `201`
  - the response property `data/updated_at` became optional for the status `201`
  - the response property `errors` became optional for the status `400`
  - the response property `message` became optional for the status `400`
  - api tag `registrar` added
  - the request property `period` became optional

---

[Operation](https://skmtc.dev/dnsimple/apis/dnsimple-api/docs/:account/registrar/domains/:domain/renewals/post.md) - [API](https://skmtc.dev/dnsimple/apis/dnsimple-api.md) - [Page](https://skmtc.dev/dnsimple/apis/dnsimple-api/changes/:account/registrar/domains/:domain/renewals/post)