cart.choose_gift
Choose which gift to take, for a promotion that offers a menu. Anonymous (cart_id). Replaces a previous choice.
- 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 — Choosing the gift a promotion offers changes only this cart, read back no-store on the next step.
Input (JSON Schema)
Section titled “Input (JSON Schema)”{ "properties": { "cart_id": { "minLength": 1, "type": "string" }, "promotion_id": { "minLength": 1, "type": "string" }, "sku_id": { "minLength": 1, "type": "string" } }, "required": [ "cart_id", "promotion_id", "sku_id" ], "type": "object"}Result (200)
Section titled “Result (200)”{ "additionalProperties": false, "properties": { "cart_id": { "type": "string" }, "sku_id": { "type": "string" } }, "required": [ "cart_id", "sku_id" ], "type": "object"}Errors
Section titled “Errors”validation_failed (400) · unauthorized (401) · forbidden (403) · conflict (409) · internal (500)