---
title: "Edit Order"
method: PATCH
path: "/v1/orders/{order_id}"
tags: ["orders"]
---

# Edit Order

`PATCH /v1/orders/{order_id}`

Edit (amend) a resting simple limit order.

Only `qty` and `price` are editable. `qty` is the new TOTAL quantity (not remaining).
The order must be RESTING, a simple order (no iceberg/peg parent), a single-instrument
LIMIT order. Returns 202 Accepted; final status is delivered via the orders WS.

## Path parameters

- `order_id` string, uuid, required

## Request body

- OrderEditRequest — Schema for editing (amending) an existing simple limit order. `qty` is the TOTAL order quantity (not remaining) — matches Kalshi's amend semantics. At least one of `qty` or `price` must be provided.
  - `qty` number, nullable — New total order quantity
  - `price` number, nullable — New limit price (between 0 and 1)

## Response `202`

Successful Response

- OrderEditResponse — Schema for order edit response.
  - `river_order_id` string, uuid, required — Unique order identifier
  - `status` string, required — Always PENDING_AMEND. Final status (RESTING on success, REJECTED on failure) is delivered via the orders WS.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/rivermarkets/apis/river-finance-api.md) · [All operations](https://skmtc.dev/rivermarkets/apis/river-finance-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rivermarkets/river-finance-api/revisions/42a5acd1d60a/schema)