Add an order note

post/markets/{marketId}/orders/{orderId}/notes

Adds a merchant note to a bazaar order. Use this to describe packing updates, substitutions, delivery constraints, or formally reject an order.

Path Parameters

marketIdstringrequired

orderIdstringrequired

Request Body

required

application/json

contentstringrequired

Detailed description of the order update or merchant decision

actionstring ("reserved" | "packed" | "substituted" | "delayed" | "rejected")required

The type of order update

Responses

201Created

application/json

idstringrequired

contentstringrequired

actionstring ("reserved" | "packed" | "substituted" | "delayed" | "rejected")

author_namestring

Merchant or clerk who wrote the note

visibilitystring ("internal" | "buyer_visible")

Whether the note is internal or visible to the buyer

created_atstring (date-time)required

Request

curl -X POST 'https://api.cameltrading.example/v1/markets/mkt_marrakesh/orders/ord_silk_77/notes' \
  -H 'Authorization: Bearer <your-token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "content": "Two silk bolts reserved from lot lot_silk_118.",
  "action": "reserved"
}'

Response

{
  "id": "note_001",
  "content": "Two silk bolts reserved from lot lot_silk_118. Buyer requested delivery after sunset.",
  "action": "reserved",
  "author_name": "Layla bint Yusuf",
  "visibility": "buyer_visible",
  "created_at": "2026-02-15T11:00:00Z"
}