Sales orders

Update an order

Update references used for display, recipient details, metadata, and shipping routing on an API-created order. Only supplied editable fields change. Order and group identities, lines, quantities, prices, weights, and fulfillment locations cannot be changed.

put/api/external/v1/orders/{order_id}

Request

  • Base URL: http://localhost
  • URL: http://localhost/api/external/v1/orders/{order_id}
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Request body

merchant_reference1string

Corrected primary merchant reference and order display name. Must not be greater than 255 characters.

merchant_reference2string nullable

Corrected secondary merchant reference. Explicit null clears it. Must not be greater than 255 characters.

metadataobject

Complete replacement metadata object.

Example request

{
  "merchant_reference1": "b",
  "merchant_reference2": "n",
  "customer": {
    "first_name": "g",
    "last_name": "z",
    "company": "m",
    "address1": "i",
    "address2": "y",
    "postal_code": "v",
    "city": "d",
    "state": "l",
    "country": "jn",
    "phone": "i",
    "email": "mya96@example.com",
    "customer_type": "k"
  },
  "fulfillment_orders": [
    []
  ]
}

Response

Example response

{
  "data": {
    "id": "ord_x7Kq9",
    "vendor_identifier": "external-api:1:order:example",
    "external_reference": "ERP-1001",
    "name": "#1001",
    "currency": "USD",
    "total_price": "249.00",
    "total_taxes": "49.80",
    "shipping_price": "49.00",
    "weight_grams": null,
    "financial_status": "AUTHORIZED",
    "fulfillment_status": "UNFULFILLED",
    "placed_at": "2026-09-07T10:00:00+00:00",
    "merchant_reference1": "#1001",
    "merchant_reference2": null,
    "customer": {
      "first_name": "Anna",
      "last_name": "Andersson",
      "company": null,
      "address1": "Drottninggatan 1",
      "address2": null,
      "postal_code": "11151",
      "city": "Stockholm",
      "state": null,
      "country": "SE",
      "phone": "+46701234567",
      "email": "anna@example.com",
      "customer_type": null
    },
    "line_items": [
      {
        "external_reference": "LINE-1",
        "name": "Blue shirt",
        "sku": "SHIRT-BLUE-M",
        "quantity": 2,
        "unit_price": "100.00",
        "type": "physical",
        "tax_rate_basis_points": 2500,
        "total_tax_amount": "40.00",
        "attributes": {}
      }
    ],
    "metadata": {},
    "created_at": "2026-09-07T10:00:00+00:00",
    "updated_at": "2026-09-07T10:00:00+00:00",
    "fulfillment_orders": [
      {
        "external_reference": "WAREHOUSE-A",
        "shipping_method_id": null,
        "service_point_id": null,
        "location_id": "loc_x7Kq9",
        "shipping": {
          "name": null,
          "type": null,
          "class": null,
          "carrier": null,
          "tax_rate_basis_points": null,
          "location": null
        },
        "status": "OPEN",
        "request_status": "UNSUBMITTED",
        "line_items": [
          {
            "order_line_reference": "LINE-1",
            "quantity": 1,
            "quantity_remaining": 1,
            "weight_grams": 250
          }
        ]
      },
      {
        "external_reference": "WAREHOUSE-B",
        "shipping_method_id": null,
        "service_point_id": null,
        "location_id": "loc_x7Kq9",
        "shipping": {
          "name": null,
          "type": null,
          "class": null,
          "carrier": null,
          "tax_rate_basis_points": null,
          "location": null
        },
        "status": "OPEN",
        "request_status": "UNSUBMITTED",
        "line_items": [
          {
            "order_line_reference": "LINE-1",
            "quantity": 1,
            "quantity_remaining": 1,
            "weight_grams": 250
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.