---
title: "modify pending super order"
method: PUT
path: "/super/orders/{order-id}"
tags: ["Super Order"]
---

# modify pending super order

`PUT /super/orders/{order-id}`

This API can be used to modify any leg of a Super Order till it is in PENDING or PART_TRADED state.

## Path parameters

- `order-id` string, required

## Headers

- `access-token` string, required

## Request body

- SuperModifyRequest
  - `dhanClientId` string — User specific identification generated by Dhan
  - `orderId` string — Order specific identification generated by Dhan
  - `orderType` 'LIMIT' | 'MARKET' — | **Enum Values** | **Description** | |------------------|-----------------------------| | LIMIT | For Limit Order types | | MARKET | For market Order types |
  - `legName` 'ENTRY_LEG' | 'STOP_LOSS_LEG' | 'TARGET_LEG' — ENTRY_LEG - Entire Super Order can be modified, only when main order status is `PENDING`, TARGET_LEG STOP_LOSS_LEG
  - `quantity` integer — Quantity to be modified - only for ENTRY_LEG
  - `price` number, float — Price to be modified - only for ENTRY_LEG
  - `targetPrice` number, float — Target Price to be modified - ENTRY_LEG or TARGET_LEG
  - `stopLossPrice` number, float — Stop Loss Price to be modified - ENTRY_LEG or STOP_LOSS_LEG
  - `trailingJump` number, float — Stop Loss Price jump to be modified - ENTRY_LEG or STOP_LOSS_LEG

## Response `200`

Successful Operation

- OrderStatusResponse
  - `orderId` string — Order specific identification generated by Dhan
  - `orderStatus` 'TRANSIT' | 'PENDING' | 'REJECTED' | 'CANCELLED' | 'PART_TRADED' | 'TRADED' | 'EXPIRED' | 'MODIFIED' | 'TRIGGERED' | 'INACTIVE' — | **Enum Values** | **Description** | |-----------------|---------------------------------------------| | TRANSIT | Did not reach the exchange server | | PENDING | Reached at exchange end, awaiting execution | | REJECTED | Rejected at exchange/broker’s end | | CANCELLED | Cancelled by user | | PART_TRADED | Partially Executed | | TRADED | Executed | | EXPIRED | Validity of order is expired |

---

[API](https://skmtc.dev/dhan/apis/dhanhq-api.md) · [All operations](https://skmtc.dev/dhan/apis/dhanhq-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dhan/dhanhq-api/revisions/2d368b9ed32d/schema)
