Title: Renew cWatch Orders via the API  
PrimaryCategory: cWatch  
Type: Procedural  
Tags: cWatch, api, renew, order, subscription, tenure  
Source UI Terms: order-id, months, auth-userid, api-key, noOfMonths, invoice-option, discount-amount  
Source Reference: Renew cWatch Orders via the API  

Prerequisites:  
- You must have a valid reseller ID and API key.  
- You need the order ID of the existing cWatch order.  
- Know the number of months you want to renew the subscription for.  
- Decide on the invoice generation option.  

Steps:  
1) Use the PATCH HTTP method to call the API endpoint:  
   `https://httpapi.com/restapi/product/cwatch/order/{order-id}/tenure/{months}`  
2) Pass the following required query parameters in the URL:  
   - `auth-userid`: your reseller ID for authentication  
   - `api-key`: your reseller API key  
   - `noOfMonths`: number of months for the renewal subscription  
   - `invoice-option`: invoice generation option such as &quot;NoInvoice&quot;  
3) Optionally, include `discount-amount` to apply a discount on the renewal (e.g., 0 if no discount).  
4) Set the `Content-Type` header to `application/x-www-form-urlencoded`.  
5) Send the PATCH request.  
6) Receive a response JSON indicating the renewal status with the order ID and &quot;Success&quot; or other status message.  

Example request:  
```
PATCH https://httpapi.com/restapi/product/cwatch/order/854193/tenure/12?auth-userid=0&amp;api-key=key&amp;noOfMonths=12&amp;invoice-option=NoInvoice&amp;discount-amount=0
Content-Type: application/x-www-form-urlencoded
```

Example response:  
```json
{
  &quot;orderid&quot;: &quot;854193&quot;,
  &quot;status&quot;: &quot;Success&quot;
}
```

Summary:  
You can renew an existing cWatch order by sending a PATCH request to the API with required parameters including order ID, renewal duration, and authentication details. The API returns the renewal status and updated tenure.

Evaluation Pairs:  
Q: How do I specify the number of months to renew a cWatch order via the API?  
A: Use the `noOfMonths` parameter in the API URL query string with the number of months you want to renew.

Q: What HTTP method is used to renew a cWatch order using the API?  
A: The PATCH method is used.

Q: Can I apply a discount when renewing a cWatch order through the API?  
A: Yes, you can optionally set the `discount-amount` parameter to specify a discount.

<h1>Description</h1>
<p>Renews an existing cWatch order for a specified number of months.</p>
<h2><a name="heading_0"></a>Parameters</h2>
<table style="width: 597.971px;"><tbody><tr><th colspan="1" rowspan="1">Name</th><th colspan="1" rowspan="1">Data Type</th><th colspan="1" rowspan="1">Required / Optional</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">order-id</td><td colspan="1" rowspan="1">Integer</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">The ID of the order to renew (passed in the URL path)</td></tr><tr><td colspan="1" rowspan="1">months</td><td colspan="1" rowspan="1">Integer</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Number of months for the renewal tenure (passed in the URL path)</td></tr><tr><td colspan="1" rowspan="1">auth-userid</td><td colspan="1" rowspan="1">Integer</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Reseller ID (Authentication Parameter)</td></tr><tr><td colspan="1" rowspan="1">api-key</td><td colspan="1" rowspan="1">String</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Reseller API key (Authentication Parameter)</td></tr><tr><td colspan="1" rowspan="1">noOfMonths</td><td colspan="1" rowspan="1">Integer</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Subscription duration in months (e.g. 12)</td></tr><tr><td colspan="1" rowspan="1">invoice-option</td><td colspan="1" rowspan="1">String</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Invoice generation option (e.g. NoInvoice)</td></tr><tr><td colspan="1" rowspan="1">discount-amount</td><td colspan="1" rowspan="1">Float</td><td colspan="1" rowspan="1">Optional</td><td colspan="1" rowspan="1">Discount amount to apply (e.g. 0)</td></tr></tbody></table>
<h2><a name="heading_1"></a>HTTP Method</h2>
<p>PATCH</p>
<h2><a name="heading_2"></a>Example Request</h2>
<pre>PATCH <a href="https://httpapi.com/restapi/product/cwatch/order/854193/tenure/12?auth-userid=0&amp;api-key=key&amp;noOfMonths=12&amp;invoice-option=NoInvoice&amp;discount-amount=0" target="_blank">https://httpapi.com/restapi/product/cwatch/order/854193/tenure/12?auth-userid=0&amp;api-key=key&amp;noOfMonths=12&amp;invoice-option=NoInvoice&amp;discount-amount=0</a></pre>
<p>Content-Type: application/x-www-form-urlencoded</p>
<h2><a name="heading_3"></a>Response</h2>
<p>Returns the status of the renewal, including the updated order tenure. Representative example:</p>
<pre>{ &quot;orderid&quot;: &quot;854193&quot;, &quot;status&quot;: &quot;Success&quot; }</pre>

Name	Data Type	Required / Optional	Description
order-id	Integer	Required	The ID of the order to renew (passed in the URL path)
months	Integer	Required	Number of months for the renewal tenure (passed in the URL path)
auth-userid	Integer	Required	Reseller ID (Authentication Parameter)
api-key	String	Required	Reseller API key (Authentication Parameter)
noOfMonths	Integer	Required	Subscription duration in months (e.g. 12)
invoice-option	String	Required	Invoice generation option (e.g. NoInvoice)
discount-amount	Float	Optional	Discount amount to apply (e.g. 0)