order.comment.add

Add a staff comment to the order timeline (free text, attributed to the caller). INTERNAL FACE ONLY — the customer’s own order read never returns it.

• Scope: order.write
• System: no
• Reachable from: POST /v1/commands/order.comment.add (tenant credential) · MCP tool order.comment.add · SDK client.call('order.comment.add', …)
• Events: order.comment.added

Input (JSON Schema)

{
  "properties": {
    "body": {
      "maxLength": 4000,
      "minLength": 1,
      "type": "string"
    },
    "order_id": {
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "order_id",
    "body"
  ],
  "type": "object"
}

Result (200)

{
  "additionalProperties": false,
  "properties": {
    "kind": {
      "type": "string"
    },
    "order_id": {
      "type": "string"
    }
  },
  "required": [
    "order_id",
    "kind"
  ],
  "type": "object"
}

Errors

validation_failed (400) · unauthorized (401) · forbidden (403) · conflict (409) · internal (500)