# Stock updated event

Sent when item availability changes at a location. A single event
can contain multiple items. Use GET /locations/{location_id}/inventory
as a polling fallback.

Endpoint: POST stock-updated
Version: 1.0.0
Security: 

## Request fields (application/json):

  - `event_id` (string, required)
    Unique identifier for this event. Use for idempotent processing.

  - `event_type` (string, required)
    The type of event that occurred. Determines the shape of the data field.

  - `created_at` (string, required)
    When the event occurred (ISO 8601 UTC).

  - `data` (object, required)
    Event-specific payload. Shape depends on event_type.
See individual event schemas for details.

  - `data.location_id` (string, required)
    The location where stock changed.

  - `data.items` (array, required)
    Items whose availability status changed. A single event can
report multiple item changes at the same location.

  - `data.items.item_id` (string, required)
    Unique identifier for the menu item.

  - `data.items.name` (string, required)
    Item name for display/logging convenience.

  - `data.items.previous_status` (string, required)
    Item availability status at a location.

- IN_STOCK: Item is available for ordering.
- LOW_STOCK: Item is available but quantities are limited. The threshold
  for LOW_STOCK is configured server-side per location.
- OUT_OF_STOCK: Item is not available for ordering. Do not display this
  item as orderable to customers.
    Enum: "IN_STOCK", "LOW_STOCK", "OUT_OF_STOCK"

  - `data.items.current_status` (string, required)
    Item availability status at a location.

- IN_STOCK: Item is available for ordering.
- LOW_STOCK: Item is available but quantities are limited. The threshold
  for LOW_STOCK is configured server-side per location.
- OUT_OF_STOCK: Item is not available for ordering. Do not display this
  item as orderable to customers.
    Enum: "IN_STOCK", "LOW_STOCK", "OUT_OF_STOCK"

  - `data.items.updated_at` (string, required)
    When this item's stock status changed.


## Response 200 fields