v57

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-07-2161198428.4 KB
Positions

Cancel Position Instruction

Cancel an outstanding position instruction by its server-assigned id. Returns the updated instruction with status CANCEL_REQUESTED. The terminal CANCELLED or CANCEL_FAILED state arrives asynchronously and is observable via subsequent GETs.

delete/v1/accounts/{account_id}/positions/instructions/{instruction_id}

Path parameters

account_idinteger required

Account identifier

instruction_idstring uuid required

Server-assigned instruction id

Response

Cancel accepted

Example response

{
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero"
  },
  "data": {
    "accepted_quantity": null,
    "account_id": 122503,
    "created_at": "2026-04-24T14:30:00Z",
    "id": "0195f6d0-a1b2-7c3d-8e4f-5a6b7c8d9e02",
    "instruction_id": "ui-20260424-001",
    "instruction_type": "EXERCISE",
    "instrument_id": "0195f6d0-a1b2-7c3d-8e4f-5a6b7c8d9e02",
    "quantity": "1",
    "rejection_reason": null,
    "status": "SENT",
    "symbol": "AAPL  280121C00195000",
    "updated_at": "2026-04-24T14:30:00Z"
  }
}