# 6 Updating SSL Order

##### *This is a series of articles dedicated to demonstrating how to get acquainted with [Openprovider SSL API methods](https://support.openprovider.eu/hc/en-us/sections/360004444873-SSL-API-Guides). If you want to go the beginning of this guide, please navigate to the article "[1 How to choose a product](https://openprovider.help/books/api-plugins/page/1-choosing-a-product)".*

*To get more information about our API in general, please [use our documentation portal](https://docs.openprovider.com/doc/all#operation/UpdateOrder) as your reference.*

<div id="bkmrk-using-the-previous%C2%A0m"><div>  
</div><div>Using the previous method "[5 Retrieving SSL Orders](https://openprovider.help/books/api-plugins/page/5-retrieving-ssl-orders)" we successfully retrieved our orders and details.  
</div></div><div id="bkmrk-but-what-if-you-want">But what if you want to update the original parameter(s) of an order created but was not yet approved?</div><div id="bkmrk-there-are-different-">There are different cases to use this method:</div><div id="bkmrk-%C2%A0ssl-order-status-%C2%A0-"><table><tbody><tr><td> [SSL Order status](https://openprovider.help/books/api-plugins/page/api-guides-glossary#order_status_list)</td><td> What can be updated</td></tr><tr><td> PAI</td><td>- All fields that are not connected with the product details, e.g. csr, organization\_handle, etc.
- send start\_provision = true if you want to send certificate request to the [CA](https://openprovider.help/books/api-plugins/page/api-guides-glossary#ca)

</td></tr><tr><td> REQ</td><td> domain\_validation\_methods can be updated, e.g. change [method](https://openprovider.help/books/api-plugins/page/api-guides-glossary#dcv) from http to dns</td></tr><tr><td> PAI, REQ, ACT</td><td> autorenew can be switched on/off</td></tr></tbody></table>

  
</div><div id="bkmrk-however%2C-for-the-ssl">However, for the SSL order in status REQ approver email address value can be modified with the [update approver email address](https://openprovider.help/books/api-plugins/page/7-updating-an-approver-email-address) method.  
  
</div><div id="bkmrk-use-endpoint-path-be"><div>![Entering Geo Fence icon](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-d9nojsdx.png)Use endpoint path below. Base URL is determined by both the target environment and API version.</div><div></div></div>```
<strong>POST <a href="https://docs.openprovider.com/doc/all#operation/UpdateOrder">{base_url}</a></strong>/ssl/orders/<a href="https://openprovider.help/books/api-plugins/page/api-guides-glossary#op_order_id"><strong>{id}</strong></a><br></br>
```

<div id="bkmrk-request-values-name-"><div id="bkmrk-request-values-name--1"><details><summary>REQUEST VALUES</summary>

<div><table><tbody><tr><th>### **Name**

</th><th>### **Type**

</th><th>### **Values**

</th><th>### **Description**

</th></tr><tr><td> **id**

</td><td> integer</td><td> Mandatory field.  
Openprovider order ID.

</td></tr><tr><td> approver\_email

</td><td> string </td><td> Email address.</td><td> A valid email address from a [pre-approved list](https://openprovider.help/books/api-plugins/page/3-retrieving-list-of-an-approver-emails). (e.g. admin@example.com).</td></tr><tr><td> autorenew

</td><td> string</td><td> on or off</td><td> Indicates if the certificate should be automatically renewed (check [renew process description](https://openprovider.help/books/api-plugins/page/10-renewing-ssl-certificate) for the details).</td></tr><tr><td>[ csr](https://openprovider.help/books/api-plugins/page/api-guides-glossary#csr)</td><td> string</td><td> [CSR](https://openprovider.help/books/api-plugins/page/api-guides-glossary#csr) value.</td><td> Certificate signing request including information regarding the further certificate. </td></tr><tr><td>1. domain\_validation\_methods</td><td> array</td><td> Allows to select a specific method for Domain Validation. Hostnames in the array must be equal to hostnames specified in the request (commonName and SANs from the CSR and hostnames).</td></tr><tr><td> 1.1 host\_name</td><td> string</td><td> Hostname specified in the request (commonName and SANs from the CSR and hostnames).</td></tr><tr><td> 1.2 method</td><td> string</td><td>- [https](https://openprovider.help/books/api-plugins/page/api-guides-glossary#dcv)
- [dns](https://openprovider.help/books/api-plugins/page/api-guides-glossary#dcv)
- [email](https://openprovider.help/books/api-plugins/page/api-guides-glossary#dcv)

</td><td> Mandatory parameter. The validation method (e.g. 'https')</td></tr><tr><td> host\_names</td><td> array</td><td>An array of strings.</td><td> Array of hostnames. This parameter is optional, and only allowed in combination with a multi domain SSL certificate. If passed, the hostnames in this parameter will override any hostnames in the CSR, except for the common name.</td></tr><tr><td> organization\_[handle](https://openprovider.help/books/api-plugins/page/api-guides-glossary#handle)

</td><td> string</td><td> Openprovider contact [handle](https://openprovider.help/books/api-plugins/page/api-guides-glossary#handle). </td><td> Internal organization [handle](https://openprovider.help/books/api-plugins/page/api-guides-glossary#handle) stored in resellers profile  
(e.g. format: XY012345-CC).</td></tr><tr><td>signature\_hash\_algorithm

</td><td>string</td><td>sha1 (deprecated) or sha2 (default)</td><td>Deprecated functional, please ignore.  
Default is: "sha2".</td></tr><tr><td> software\_id

</td><td> string </td><td> linux or windows.</td><td> Certificate software platform.  
Used if you changed your system configuration from Linux to Windows Server and vice versa.</td></tr><tr><td> start\_provision

</td><td> boolean </td><td> true or false (default)</td><td> If **false** then order won't be sent to [CA](https://openprovider.help/books/api-plugins/page/api-guides-glossary#ca), it will be in status [PAI](https://openprovider.help/books/api-plugins/page/api-guides-glossary#order_status_list). To request it use **true** value.</td></tr><tr><td> technical\_[handle](https://openprovider.help/books/api-plugins/page/api-guides-glossary#handle)

</td><td>string </td><td> Format: "XY012345-CC"</td><td> Openprovider technical [handle](https://openprovider.help/books/api-plugins/page/api-guides-glossary#handle).</td></tr></tbody></table>

  
  
</div></details><details><summary>REQUEST EXAMPLE</summary>

```
curl -X PUT \<br></br> https://api.cte.openprovider.eu/v1beta/ssl/orders/31027 \<br></br> -H 'Authorization: Bearer deb4bf804928981b018caf45c3c4142b' \<br></br> -H 'Content-Type: application/json' \<br></br> -d '{<br></br> "approver_email": "admin@ssl-123-domain.com",<br></br> "autorenew": "on",<br></br> "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIIDNzCCAh8CAQAwgaUxCzAJBgNVBAYTAk5MMRYwFAYDVQQIEw1Ob29yZC1Ib2xs\n<br></br>YW5kMQ8wDQYDVQQHEwZIYWFsZW0xGjAYBgNVBAoTEU9wZW5wcm92aWRlciBCLlYu\nMQswCQYDVQQLEwJJVDEbMBkGA1UEAxMSc3NsLTEyMy1kb21haW4uY29tMScwJQYJ\n<br></br>KoZIhvcNAQkBFhhhZG1pbkBzc2wtMTIzLWRvbWFpbi5jb20wggEiMA0GCSqGSIb3\nDQEBAQUAA4IBDwAwggEKAoIBAQD4t7KW7vJ8Zjw9xZMo1iU4ez7pdPPglmSNNRAk\n<br></br>iJXzTda9cIYPjwxduUR7A8EsgxFT/jQ99Gmjyq85liSX45z88eT5a7f84alEfCui\nMzZh9DUK6Y8nigATFnjOohJhkEXXay8K0fY7/DXD6dSqJYJkhqULedsvB64ofip0\n<br></br>0ab8PlgOkdphcLUxKOGcpt8xWpzgKpMTJJnmRVkI7rkikYAU7BWxtJ5tcg/lEFcl\nruh/WUxeBH6qJMZ5xHZ2Z1EWLjiVGb6Mw+sYBUky4WDX9xefv2wl48dEA3opWR9e\n<br></br>vTL/8Omo7xDk3vN4nEOAl9cT8gidVHuA+YOLMczLLrhP8LRPAgMBAAGgTDBKBgkq\nhkiG9w0BCQ4xPTA7MAkGA1UdEwQCMAAwCwYDVR0PBAQDAgXgMCEGA1UdEQQaMBiC\n<br></br>Fnd3dy5zc2wtMTIzLWRvbWFpbi5jb20wDQYJKoZIhvcNAQELBQADggEBAJVyt+D8\nBDxcQhuT4kOd8A2u0a+T0PAXX7uJcu1AkJr1gMS6tym118nmjXLilgSsL3IarRq2\n<br></br>1taUMoxlyZuXe38IztCBuUxpKiZz6Ltx5yUrQZaFNNOVsHNjXHe5oajVA1f7dmoI\nIa3E/fpeHpoPzbWdTv1bfMHuAfHIRqVuTHG78T4fJh4JFXfyHfVbLUN5wc9D7oPo\n<br></br>amGOFSUZoY/HLwfGf1zJMqsF9HEreCVmhWGoIHknzKbIhe7sngzR1We3aafNAUOd\nQ3gov4okpEI8yurKRrGSSo1ZzWqiIew5qEkm6gNGAwVWYgZ0kgadXjJQEBdx6deZ\n<br></br>4eJiaV7IwubPS78=\n-----END CERTIFICATE REQUEST-----",<br></br> "domain_validation_methods": [<br></br> {<br></br> "host_name": "ssl-123-domain.com",<br></br> "method": "http"<br></br> }<br></br> ],<br></br> "host_names": [<br></br> "ssl-123-domain.com"<br></br> ],<br></br> "organization_handle": "<a href="https://openprovider.help/books/api-plugins/page/api-guides-glossary#handle">IA900531-NL</a>",<br></br> "signature_hash_algorithm": "sha2",<br></br> "software_id": "windows",<br></br> "start_provision": true,<br></br> "technical_handle": "<a href="https://openprovider.help/books/api-plugins/page/api-guides-glossary#handle">IA900531-NL</a>"<br></br>}'
```

</details><details><summary>RESPONSE EXAMPLE</summary>

```
{<br></br>"code": 0,<br></br>"data": {<br></br>"id": 1<br></br>},<br></br>"desc": ""<br></br>}
```

</details><details><summary>RESPONSE VALUES</summary>

<div><table><tbody><tr><th>### **Name**

</th><th>### **Values**

</th><th>### **Description**

</th></tr><tr><td>code

</td><td>API code returned.</td><td>**[API Result with code returned](https://openprovider.help/books/api-plugins/page/api-error-codes).  
0 = Sucess with no errors.**

</td></tr><tr><td>1\. data

</td><td>Update Order Response Data</td><td>Response data returned while updating the order.</td></tr><tr><td>1.1 id

</td><td>Digital value usually consists of 6 digits.</td><td>[Openprovider order ID](https://openprovider.help/books/api-plugins/page/api-guides-glossary#op_oprder_id).</td></tr><tr><td>desc

</td><td>Description text (if presented).</td><td>Description (if presented). </td></tr><tr><td>maintenance

</td><td>Boolean parameter: True or False.</td><td>The Maintenance: True or False.</td></tr><tr><td>**2. warnings**

</td><td>An array of warning messages</td><td>Warning data returned while updating the order.</td></tr><tr><td>2.1 code

</td><td>Numeric code if warning(s) detected.</td><td>Code value (digits). </td></tr><tr><td>2.2 data

</td><td>Warning data values.</td><td>Data value returned. </td></tr><tr><td>2.3 desc

</td><td>Description of warnings.</td><td>The description value returned. </td></tr></tbody></table>

</div></details></div></div>**Now we have updated our order and sent request to te [CA](https://openprovider.help/books/api-plugins/page/api-guides-glossary#ca) (now order [status](https://openprovider.help/books/api-plugins/page/api-guides-glossary#dcv) is REQ).  
In the next method, we will try "[7 Update approver email](https://openprovider.help/books/api-plugins/page/7-updating-an-approver-email-address)" cause that help you if you no longer have an access to initial email used [when submitted an order](https://openprovider.help/books/api-plugins/page/4-creating-ssl-order) in a case if you used email domain validation method.**