---
title: "Update an existing order"
method: POST
path: "/v1/orders/{orderId}"
tags: ["Orders"]
---

# Update an existing order

`POST /v1/orders/{orderId}`

## Request

- Base URL: `https://api.bluehive.com`
- URL: `https://api.bluehive.com/v1/orders/{orderId}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bluehive-health/apis/bluehive-api/docs/v1/orders/:orderId/post.ts> (a function with typed inputs; its response is checked against the schema)

Update order details and associated order items. Allows updating order status, metadata, and modifying order item services.

## Path parameters

- `orderId` string, required

## Request body

- object
  - `status` 'order_sent' | 'order_accepted' | 'order_refused' | 'employee_confirmed' | 'order_fulfilled' | 'order_complete'
  - `metadata` object: Arbitrary metadata to update on the order (non-indexed passthrough, <=10KB when JSON stringified)
  - `services` object[]
    - `serviceId` string, required
    - `status` 'pending' | 'in_progress' | 'completed' | 'cancelled' | 'rejected'
    - `results` object
    - `dueDate` string, date-time

## Response `200`

Default Response

- object
  - `success` true, required
  - `message` string, required
  - `orderId` string, required
  - `orderNumber` string, required
  - `updatedFields` string[]

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `500`: Default Response

## Changes

- **2026-10-16** `a8bcbdf02e33`: 2 warning
  - removed the request property `expirationDate`
  - removed the request property `services/items/expirationDate`
- **2026-06-03** `088f5a47edc2`: 2 info
  - added the new optional request property `expirationDate`
  - added the new optional request property `services/items/expirationDate`
- **2025-10-05** `28d439490b5e`: 1 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
- **2025-10-05** `3c4bce10c1fe`: 1 info
  - the endpoint scheme security `ApiKeyAuth` was removed from the API
- **2025-10-05** `28d439490b5e`: 1 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API

[Operation history](https://skmtc.dev/bluehive-health/apis/bluehive-api/changes/v1/orders/:orderId/post.md)

---

[API](https://skmtc.dev/bluehive-health/apis/bluehive-api.md) - [All operations](https://skmtc.dev/bluehive-health/apis/bluehive-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluehive-health/apis/bluehive-api/revisions/a8bcbdf02e33?raw)