shop-app

You can track orders and manage returns across stores by using the Shop.app agent API flow. It fetches your order status and initiates returns or reorders per user after completing a device authorization flow.

Product search works without authentication to find and compare items across shops. However, per-user actions like order tracking, returns, and reorders require device authorization to access your personal data.

Device authorization enables secure access to your personal order history by generating tokens that live only in the current session and never persist. This protects your account while allowing order tracking and returns.

Reordering a previous purchase uses the Shop.app agent API to fetch your order history and initiate a reorder. After device authorization, the API returns plain-text markdown responses to guide the reorder process.

Product visualizations are available for eligible items using image generation capabilities. This optional try-on feature helps you preview products visually when searching and comparing options across stores.

The API returns plain-text markdown for all responses, which means structured data parsing may require additional formatting. Session tokens never persist, so each new session requires reauthorization for personal actions.