domains.renew
Renew a domain already managed through this Vee3 account.
The user or agent passes expected_token_cost from domains.renewal_quote. Charges the quoted token cost on success. Premium domains can only be renewed for 1 year at a time.
Cost = 100 tokens + domain renewal price in tokens.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| years | No | Renewal term in years. Premium domains support 1 year only. | |
| domain | Yes | Managed domain name to renew (for example example.com). | |
| expected_token_cost | Yes | Token cost from a fresh domains.renewal_quote response. Required to prevent surprise charges. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| years | No | Renewal term in years. | |
| domain | No | Renewed domain name. | |
| renewed | No | Whether renewal completed successfully. | |
| order_id | No | Namecheap order identifier for the renewal purchase. | |
| expires_at | No | Updated domain expiration timestamp when known. | |
| token_cost | No | Tokens charged for this renewal (100 service tokens plus the domain renewal price in tokens). | |
| namecheap_domain_id | No | Namecheap domain identifier for the managed domain. |