Filter the orders list by a saved Refine filter
The orders index now accepts a saved Refine filter, so you can reuse a segment you already built in the app instead of rebuilding its conditions as query parameters. Pass the filter's stable_id (or its stored_filter_id) to GET /api/v2/workspaces/:workspace_id/orders and you get back exactly the orders that filter selects. Filters are resolved against your own workspace only, and an unknown or out-of-workspace id is rejected rather than silently ignored.
Agent examples: ask an agent for "this month's orders from my high-value segment" and let it apply the saved filter by id · reconcile a saved-filter order set on a schedule without duplicating the filter logic in your code.
Resources: Order · Refine::Filter
Building with an AI agent? Point it at the Orders skill.