Merchandising Area

BETA

Agent Gateway is in BETA, and we're continuing to expand its capabilities. Your feedback helps shape what we build next—reach out to us through Relewise Support.

Merchandising rules influence Search and Recommendation results by boosting, burying, filtering, or pinning Products, Product Categories, Content, and Content Categories. Connected tools can inspect existing rules and control whether and when a rule is active.

The Merchandising area must be allowed in the Agent Gateway Configuration before its REST endpoints or MCP tools can be used.

Merchandising Rules

Capability	REST Endpoint	MCP Tool
List rules	GET /merchandising/rules	list_merchandising_rules
Get a rule	GET /merchandising/rules/{Rule ID}	get_merchandising_rule
Enable or disable a rule	PATCH /merchandising/rules/{Rule ID}	set_merchandising_rule_enabled
Set a rule schedule	PATCH /merchandising/rules/{Rule ID}	set_merchandising_rule_schedule

Rule details include the rule's type, state, schedule, targeting, and type-specific configuration. The available update operations change whether and when a rule is active without changing its definition or targeting configuration.

REST updates use partial-update semantics. Omit enabled or set it to null to preserve the current enabled state. Omit schedule or set it to null to preserve the entire current schedule. To change the schedule, provide a schedule object; within that object, a null startsAt or endsAt removes that time bound.

Updating a rule can change live Dataset behavior. List rules when the Rule ID is unknown, inspect the selected rule, and update it only when the requested change is explicit.

See Merchandising for the supported rule types and how they affect Search and Recommendation results.

REST endpoint paths in the table are relative to:

https://my.relewise.com/agents/api/v1/datasets/{Dataset ID}

See Get Started with Agent Gateway for connection and authentication instructions.