Renew domain

Renew a managed domain through Vee3 using a fresh renewal quote.

← All Domains endpoints · Capability overview

POST/v1/domains/renew

https://api.vee3.io/v1/domains/renew

100 tokens

Renew a managed domain through Vee3 using a fresh renewal quote.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

domains.renew

Parameters3 fields

domainstringRequired

Managed domain name to renew (for example example.com).

yearsintegerOptional

Renewal term in years. Premium domains support 1 year only.

Default: 1 · min 1, max 10

expected_token_costintegerRequired

Token cost from a fresh domains.renewal_quote response. Required to prevent surprise charges.

Response7 fields

domainstring

Renewed domain name.

renewedboolean

Whether renewal completed successfully.

yearsinteger

Renewal term in years.

token_costinteger

Tokens charged for this renewal (100 service tokens plus the domain renewal price in tokens).

namecheap_domain_idstring

Namecheap domain identifier for the managed domain.

order_idstring

Namecheap order identifier for the renewal purchase.

expires_atstring

Updated domain expiration timestamp when known.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, domains_not_configured, domains_upstream_error, domain_unavailable, token_cost_mismatch, domain_not_found

Example request

Python

import requests

url = "https://api.vee3.io/v1/domains/renew"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "domain": "my-managed-site.com",
    "years": 1,
    "expected_token_cost": 31732
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample successful domain renewal response.

successful_renewal.json

{
  "domain": "my-managed-site.com",
  "renewed": true,
  "years": 1,
  "token_cost": 31732,
  "namecheap_domain_id": "12345678",
  "order_id": "987654321",
  "expires_at": "2028-07-31T00:00:00.000Z"
}