Skip to content

Transform config reference

result_transform is JSON config on an API Request (or eligible MCP) tool. Chatevo applies it to successful responses before sending content to the widget.

Top-level fields

Field	Type	Description
`items_path`	string	Dot path to array of items (e.g. `data.offers`, `products`)
`layout`	enum	`carousel`, `grid`, `list`, `single`
`card_type`	enum	`product`, `media`
`sort_by`	string	`field:asc` or `field:desc` — supports nested paths
`limit`	integer	Max items to render
`actions`	array	Button labels shown on each card
`fields`	object	Maps card slots to JSON paths

fields mapping

Each key is a card slot; value is a path into each item object (relative to items in the array):

{
  "items_path": "data.offers",
  "layout": "carousel",
  "card_type": "media",
  "sort_by": "totalGrossAmount.amount:asc",
  "limit": 8,
  "actions": ["Book This Room", "More Details"],
  "fields": {
    "title": "title",
    "subtitle": "roomCategory",
    "image_url": "photos.0.url",
    "price": "totalGrossAmount.amount",
    "currency": "totalGrossAmount.currency",
    "url": "deepLink"
  }
}

Path syntax

Pattern	Meaning
`name`	Property on item
`price.amount`	Nested object
`images.0.url`	Array index
`metadata.tags.0`	Mixed nesting

sort_by

Format: path:direction

Example	Effect
`price:asc`	Cheapest first
`totalGrossAmount.amount:desc`	Highest price first
`rating:desc`	Top rated first

actions

Array of strings — button labels in order. Link targets come from mapped url or action-specific paths if configured in your transform variant.

When transform is skipped

Condition	Result
Tool HTTP error	No rich content
`items_path` missing or empty array	Text-only reply
Invalid paths	Logged; cards omitted or partial

Testing

Test the tool with real API JSON.
Confirm items at items_path match expected count.
Preview in assistant chat before production deployment.