> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://plantstore.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://plantstore.dev/_mcp/server.

# Changelog

## October 29, 2025

## Enhancements

### Inventory tracking improvements

Added new `reserved` field to inventory responses, allowing better tracking of stock allocated to pending orders.

### Bulk operations

Introduced `/inventory/batch-update` endpoint for updating multiple plant inventory levels in a single request.

## Bug fixes

* Fixed an issue where low stock alerts weren't triggering when inventory reached exactly the reorder point
* Corrected timezone handling in inventory history timestamps

## October 15, 2025

## New features

### Webhook events

Added support for new webhook events:

* `inventory.low_stock` - Triggered when stock falls below reorder point
* `inventory.restocked` - Triggered when items are restocked
* `customer.updated` - Triggered when customer profile is modified

### Multi-location inventory

Inventory endpoints now support `location` parameter for tracking stock across multiple warehouses and greenhouses.

## Enhancements

* Improved webhook retry logic with exponential backoff
* Added `tracking_number` and `carrier` fields to order responses

## October 1, 2025

## New features

### Customer loyalty program

Introduced new `/customers/{id}/loyalty` endpoint for accessing customer loyalty points and rewards.

### Wishlist functionality

Customers can now maintain wishlists:

* `POST /customers/{id}/wishlist` - Add plants to wishlist
* `GET /customers/{id}/wishlist` - Retrieve wishlist
* `DELETE /customers/{id}/wishlist/{plant_id}` - Remove from wishlist

## Breaking changes

### Order status field

The order `status` field now uses standardized values. Legacy status values will be deprecated on December 1, 2025:

* `pending_payment` → `pending`
* `in_progress` → `processing`

Please update your integrations to use the new values.

## Enhancements

* Added pagination support to `/plants` endpoint with `limit` and `offset` parameters
* Improved error messages with more detailed validation feedback

## September 15, 2025

## New features

### Plant care requirements

Added detailed care information to plant objects:

* `light_requirements` - Light level needs (low, medium, bright indirect, full sun)
* `water_frequency` - Watering schedule recommendations
* `temperature_range` - Ideal temperature range
* `humidity_level` - Humidity preferences

### Advanced filtering

Plant search now supports filtering by care requirements:

```bash
GET /plants?care_level=easy&light_requirements=low
```

## Enhancements

* Increased rate limit from 1000 to 5000 requests per hour for production API keys
* Added response caching headers to improve performance
* Order confirmation emails now include estimated delivery date

## Bug fixes

* Fixed pagination issue in customer order history
* Resolved incorrect stock calculations when orders were cancelled

## September 1, 2025

## New features

### Order refunds API

Introduced comprehensive refund management:

* `POST /orders/{id}/refund` - Process full or partial refunds
* `GET /orders/{id}/refunds` - View refund history
* Automatic inventory restoration on refunded items

### Webhook signature verification

All webhooks now include `x-plantstore-signature` header for verifying webhook authenticity using HMAC-SHA256.

## Enhancements

* Added `description` field to plant objects for detailed product information
* Customer addresses can now be labeled (e.g., "Home", "Work", "Gift Address")
* Improved API response times by 40% through database optimization

## Documentation

* Added new tutorial: "Managing plant inventory"
* Updated webhook setup guide with signature verification examples
* Added code samples for Python, JavaScript, and Go SDKs