---
title: "Update order"
method: PATCH
path: "/orders/{order_id}"
tags: ["Orders"]
---

# Update order

`PATCH /orders/{order_id}`

Update an order's status or notes.

    Available status transitions:
    - `confirmed` - Approve a pending order
    - `completed` - Mark a confirmed order as fulfilled
    - `refused` - Refuse a pending order (requires status_reason)

    Note: Orders cannot be cancelled via this endpoint.
    Cancellation is only available to customers via the public order link.

    Authentication:
    - API key with READ_WRITE permission

## Path parameters

- `order_id` string, uuid, required

## Request body

- object — Schema for updating an order via external API.
  - `status` string, nullable — Order status (confirmed, completed, refused)
  - `notes` string, nullable — Additional notes
  - `status_reason` string, nullable — Reason for refusing the order (required when status is 'refused')

## Response `200`

Successfully updated order

- object
  - `ok` boolean
  - `data` object

## Other responses

- `400` — Invalid request data
- `401` — Invalid or missing API key
- `403` — Insufficient permissions
- `404` — Resource not found

---

[API](https://skmtc.net/yourang/apis/yourang-ai-external-api-v1.md) · [All operations](https://skmtc.net/yourang/apis/yourang-ai-external-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yourang/yourang-ai-external-api-v1/versions/49680ee64400/schema)