Title: Delete a Block Storage Order Using the API  
PrimaryCategory: API  
Type: Procedural  
Tags: block_storage, order_deletion, api, authentication, http_post  
Source UI Terms: auth-userid, api-key, order-id  
Source Reference: Delete a Block Storage Order Using the API  

---

### Procedural

Prerequisites:
- You must have valid API authentication credentials: auth-userid (Integer) and api-key (String).
- You must know the order-id (Integer) of the Block Storage order you want to delete.

Steps:
1) Construct a POST HTTP request to the API endpoint for deleting a block storage order.
2) Include the following required parameters in the request URL or body:
   - `auth-userid`: Your API authentication user ID.
   - `api-key`: Your API key string.
   - `order-id`: The ID representing the specific order to delete.
3) Send the POST request to the US server test URL:
   ```
   https://test.httpapi.com/api/blockstorage/us/delete.json?auth-userid=YOUR_USERID&amp;api-key=YOUR_APIKEYℴ-id=ORDER_ID
   ```
4) Review the response, which will return a map containing execution details about the delete operation.

Warnings:
- Only include the required parameters as specified.
- Ensure you are using the POST HTTP method.
- Confirm you have the correct order-id to avoid deleting the wrong order.

Summary:
To delete a Block Storage order using the API, send a POST request with your auth-userid, api-key, and the order-id to the specified endpoint. The system then returns the execution details of the deletion.

Evaluation Pairs:

Q: What parameters must I include to delete a Block Storage order using the API?  
A: You must include `auth-userid` (Integer), `api-key` (String), and the `order-id` (Integer) of the order to be deleted.

Q: Which HTTP method is required to delete a Block Storage order via the API?  
A: The POST HTTP method must be used.

Q: How do I get confirmation that a Block Storage order was deleted?  
A: The API returns a map containing execution details of the delete operation in the response.

<p>When you want to delete an existing Block Storage order using the API. This article explains the required parameters and example API request to delete the order.</p>
<div class="region region-content">
<div class="hidden"> </div>
<div class="block block-core block-page-title-block" id="block-twostates-page-title">
<div class="content">
<h1 class="title page-title"><span class="field field--name-title field--type-string field--label-hidden">Delete</span></h1>
<div id="toc" style="display: block;">
<div id="toc_content">
<p> </p>
</div>
</div>
</div>
</div>
<div class="node__content clearfix">
<div class="layout layout--onecol">
<div class="layout__region layout__region--content">
<div class="clearfix text-formatted field field--name-body field--type-text-with-summary field--label-hidden field__item">
<h2><a name="heading_0"></a>Description</h2>
<p>Deletes an existing Block Storage Order.</p>
<h2><a name="heading_1"></a>Parameters</h2>
<table class="codetable"><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">auth-userid</td><td colspan="1" rowspan="1">Integer</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">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">Authentication Parameter</td></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">Order ID of the Order which is to be deleted</td></tr></tbody></table>
<h2><a name="heading_2"></a>HTTP Method</h2>
<p>POST</p>
<h2><a name="heading_3"></a>Example Test URL Request</h2>
<p><strong>US Server</strong> <code> https://test.httpapi.com/api/blockstorage/us/delete.json?auth-userid=0&amp;api-key=key&amp;order-id=0 </code> ¬†</p>
<h2><a name="heading_4"></a>Response</h2>
<p>Returns a map of the execution details of the delete operation.</p>
</div>
</div>
</div>
</div>
<div class="mychild-topics"> </div>
</div>
<div class="seedetailssection"> </div>

Name	Data Type	Required / Optional	Description
auth-userid	Integer	Required	Authentication Parameter
api-key	String	Required	Authentication Parameter
order-id	Integer	Required	Order ID of the Order which is to be deleted