Use PATCH with the orders endpoint to update order information. For example, build a feature to update the books purchased in an order.

Request

To update an order with PATCH, use a curl request similar to the following example, which adds an additional book. Supply your server and port and a valid order id:

curl -X PATCH '{server_url}:{port}/orders/{id}' \
--header 'Content-Type: application/json' \
--data `{
    "order_date": "2024-06-16",
    "number_of_items": 2,
    "book_id": ["03d7", "f2e5"],
    "subtotal": "22.98",
    "tax": "2.04",
    "total": "25.02"
  }'

Response

The following sections describe possible responses from the orders endpoint when using the PATCH method.

Success response

A successful PATCH returns 200 OK and the updated book object.

Error response

An error contains one of the following HTTP status codes.

Status Code Description
404 Not Found The server could not find the requested resource.
500 Service Unavailable The server could not complete the request.
ECONNREFUSED The service is unavailable.