cart.add_line

Add a sku to the cart (aggregating by sku + custom fields). Does NOT reserve stock.

• Scope: public
• System: no
• Reachable from: an ANONYMOUS face — no credential, and never /v1/commands/*. Which path serves it is not derivable from the registry; see the anonymous faces.
• Events: none — The cart is session state read no-store; durable history begins at the order.

Input (JSON Schema)

{
  "properties": {
    "cart_id": {
      "minLength": 1,
      "type": "string"
    },
    "custom_fields": {
      "additionalProperties": {},
      "default": {},
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "qty": {
      "maximum": 999,
      "minimum": 1,
      "type": "integer"
    },
    "sku_id": {
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "cart_id",
    "sku_id",
    "qty"
  ],
  "type": "object"
}

Result (200)

{
  "additionalProperties": false,
  "properties": {
    "line_id": {
      "type": "string"
    },
    "qty": {
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "type": "integer"
    }
  },
  "required": [
    "line_id",
    "qty"
  ],
  "type": "object"
}

Errors

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