---
search:
  tags:
    - Orders
    - POST
seo:
  description: >-
    Copy an order on hold. Reference for the POST
    /v1/organizations/{orgId}/orders/{orderId}/copies endpoint in the Stashtab
    Vault Warehouse API.
sidebar:
  label: Copy an order on hold
  badge: POST
title: Copy an order on hold
type: openapi-operation
---
`POST /v1/organizations/{orgId}/orders/{orderId}/copies`

**Request body** (`application/json`, required)

- `customerLabel` (string | null)
- `orderKey` (string, required)
- `orderNumber` (string, required)
- `storeLinkId` (string)
- `storeRef` (string)
- `submissionKey` (string, required)

Request body example:

```json
{
  "customerLabel": "Warehouse demo",
  "orderKey": "copy-order-demo-1",
  "orderNumber": "COPY-DEMO-1",
  "storeRef": "store_example",
  "submissionKey": "copy-order-demo-1"
}
```

**Responses**

- `200` — Success
- `default` — Error

Response example, 200:

```json
{
  "data": {
    "effects": [
      "order_associated",
      "order_copied",
      "order_on_hold"
    ],
    "operationId": "operation_copy_order_demo",
    "outcome": "confirmed",
    "order": {
      "customerLabel": "Warehouse demo",
      "id": "order_copy_demo",
      "kind": "ordinary",
      "receipt": {
        "operationId": "operation_copy_order_demo",
        "recordedAt": "2026-10-02T00:00:00.000Z"
      },
      "visibleOrderNumber": "COPY-DEMO-1",
      "current": {
        "orderDate": "2026-10-02",
        "providerOrderNumber": "demo-provider-copy-order",
        "recipientName": "Taylor Example",
        "status": "on_hold",
        "tracking": [],
        "customerNotes": null,
        "holdUntilDate": null,
        "items": [
          {
            "name": "Demo card sleeve",
            "quantity": 2,
            "sku": "ORDER-DEMO-SLEEVE"
          }
        ],
        "recipient": {
          "city": "Toronto",
          "company": null,
          "country": "CA",
          "email": "taylor@example.test",
          "name": "Taylor Example",
          "phone": null,
          "postalCode": "M5V 1E3",
          "state": "ON",
          "street1": "1 Example Street",
          "street2": null
        },
        "revision": "demo-copy-revision-1",
        "requestedShippingService": null
      },
      "sourceOrderId": "order_copy_source_demo"
    }
  },
  "meta": {
    "requestId": "example-copyOrder"
  }
}
```
