Add Order Comment

Adds a comment to an order. When customerNotified=true, the customer is sent a notification email with the comment.

No permission gate — any authenticated admin can add a comment.

Endpoint

Endpoint	Method
/api/admin/orders/{orderId}/comments	POST

Request body

Field	Type	Required	Notes
comment	string	yes	Free-form comment body.
customerNotified	boolean	no	When true, the customer is emailed the comment. Defaults to false.

Errors

HTTP	Lang key	Message
422	bagistoapi::app.admin.order.actions.comment.empty	Comment is required.

Sample 422 response

{
    "type": "/errors/422",
    "title": "Bad Request",
    "status": 422,
    "detail": "Comment is required."
}