> For the complete documentation index, see [llms.txt](https://api-documentation.autoshares.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-documentation.autoshares.dev/rest-api/trading-api/orders/replace-order/orders_replaceorder.md).

# Syntax

## Replace order

```
PUT /v{version}/accounts/{accountId}/orders/{orderId}
```

### Description

This API endpoint enables you to modify an existing order.

### Parameters

| Type       | Name                           | Description                                                                                                                                 | Schema                                                                                                       | Default |
| ---------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ------- |
| **Header** | **Authorization**   *required* | This is the authorization token that you retrieved from the first endpoint (/token).                                                        | string                                                                                                       |         |
| **Header** | **Et-App-Key**   *required*    | This is your app’s unique key that can be retrieved from the BO Companies widget in Autoshares Trader.                                      | string                                                                                                       |         |
| **Path**   | **accountId**   *required*     | This is the unique identifier of the trading account on which a new order is to be modified.                                                | integer (int32)                                                                                              |         |
| **Path**   | **orderId**   *required*       | This is the ID of the order that needs to be modified.                                                                                      | integer (int32)                                                                                              |         |
| **Path**   | **version**   *required*       | This is the version of the API. Unless you have multiple versions of Autoshares Trader’s API deployed in your environment, leave it at 1.0. | string                                                                                                       | `"1"`   |
| **Body**   | **body**   *required*          | This is JSON data that contains updated information about the modified order.                                                               | [ModifyOrderResource](/rest-api/trading-api/orders/replace-order/orders_replaceorder.md#modifyorderresource) |         |

### Responses

| HTTP Code | Description                                                                                                  | Schema                                                                                           |
| --------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
| **200**   | JSON data with the updated order information is returned, indicating if the order was successfully modified. | [OrderResource](/rest-api/trading-api/orders/replace-order/orders_replaceorder.md#orderresource) |
| **401**   | The access level of the provided authorization token is not sufficient to perform this operation.            | No Content                                                                                       |
| **403**   | The provided Et-App-Key is incorrect.                                                                        | No Content                                                                                       |
| **409**   | Conflict                                                                                                     | No Content                                                                                       |
| **422**   | A validation error occurred while processing the request.                                                    | No Content                                                                                       |
| **500**   | Internal server error                                                                                        | No Content                                                                                       |

### Consumes

* `application/json`
* `text/json`

### Produces

* `application/json`
* `text/json`