---
title: "Patch Order"
method: PATCH
path: "/crm/orders/{order_id}"
tags: ["CRM Service Calls"]
---

# Patch Order

`PATCH /crm/orders/{order_id}`

Update an existing order by ID.

Send only the fields you want to change. Returns 400 if no fields are provided.

**Path Parameters:**

- **order_id**: The order's CRM record ID.

**Request Body (OrderUpdateRequest):** Fields: stage, description, total_amount,
order_date, order_line_list. All optional — only included fields are updated.

**Response:** The updated order object.

## Path parameters

- `order_id` string, required

## Request body

- OrderUpdateRequest — Request to update an existing order.
  - `stage` string, nullable — Order stage, e.g. draft, pending, approved, fulfilled, cancelled
  - `description` string, nullable — Order description / notes
  - `total_amount` number, nullable — Total order amount
  - `order_date` integer, nullable — Order date (epoch timestamp)
  - `order_line_list` unknown[], nullable — Array of OrderLine objects, e.g. [{"description":"Widget","amount":99.99,"line_detail_dict":{"qty":1,"unit_price":99.99}}]
    - unknown

## Response `200`

Successful Response

- OrderResponse
  - `id` string, required
  - `name` string, nullable
  - `stage` string, nullable
  - `description` string, nullable
  - `order_num` string, nullable
  - `order_type` string, nullable
  - `order_date` string, nullable
  - `total_amount` string, nullable
  - `agreement_signed_date` string, nullable
  - `created_ts` string, nullable
  - `created_ts_date` string, nullable
  - `updated_ts` string, nullable
  - `updated_ts_date` string, nullable
  - `account` string, nullable
  - `primary_sales_agent_email` string, nullable
  - `contact` string, nullable
  - `opportunity` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ambivo/apis/ambivo-api.md) · [All operations](https://skmtc.net/ambivo/apis/ambivo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ambivo/ambivo-api/versions/165a6d16a9a0/schema)