---
title: "POST Renew a registered domain"
description: "Creates an invoice and charges the workspace payment method for domain renewal."
last_updated: "2026-10-05T05:08:24.165413+00:00"
canonical_url: "https://www.doc0.dev/docs/934e554a-e6a1-476f-bb2f-23e62d86c3fd/api/admin/renewadmindomain"
---

<APIEndpoint
  method={"POST"}
  path={"/api/admin/domains/renew"}
  summary={"Renew a registered domain"}
  description={"Creates an invoice and charges the workspace payment method for domain renewal."}
  deprecated={false}
  baseUrl={""}
/>

## Request Body

Domain to renew

<APIRequestBody
  contentType={"application/json"}
  required={true}
  schema={{"type":"object"}}
/>

## Responses

<APIResponse
  statusCode={"200"}
  description={"Renewal initiated or succeeded"}
  contentType={"application/json"}
/>

<APIResponse
  statusCode={"400"}
  description={"Bad Request or missing billing"}
  contentType={"application/json"}
/>

<APIResponse
  statusCode={"404"}
  description={"Domain not found"}
  contentType={"application/json"}
/>

<APIResponse
  statusCode={"409"}
  description={"Renewal already processing"}
  contentType={"application/json"}
/>

<APIResponse
  statusCode={"422"}
  description={"Payment failed"}
  contentType={"application/json"}
/>

## Try It

<APIPlayground
  method={"POST"}
  path={"/api/admin/domains/renew"}
  parameters={[]}
  requestBody={{"contentType":"application/json","required":true,"description":"Domain to renew","schema":{"type":"object"}}}
  baseUrl={""}
/>


## Sitemap

See the full [sitemap](https://www.doc0.dev/docs/934e554a-e6a1-476f-bb2f-23e62d86c3fd/llms.txt) for all pages in this wiki.