> ## Documentation Index
> Fetch the complete documentation index at: https://synthetiq.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# dataPath

> Extract nested data from service responses

Service APIs often return data nested inside a wrapper object. `dataPath` tells the workflow engine where to find the array of records in the response:

```typescript theme={null}
{
  service: "shopify",
  operation: "listOrders",
  params: { limit: 250 },
  dataPath: "data.orders",
  outputTable: "raw_orders",
  outputSchema: {
    id: "VARCHAR",
    order_number: "INTEGER",
    total_price: "VARCHAR",
  },
}
```

Given a response like `{ data: { orders: [{ id: "o1" }, { id: "o2" }] } }`, `dataPath: "data.orders"` extracts the `orders` array so each item becomes a row in the output table.

| Field      | Required | Description                                                 |
| ---------- | -------- | ----------------------------------------------------------- |
| `dataPath` | No       | Dot-notation path to the data array in the service response |

## Validation

| Check                                          |
| ---------------------------------------------- |
| `dataPath` exists in the service output schema |
