---
alias: user-guide-automation-task-core-jsonata
tags:
- automation tasks
description: "This task executes a JSONata expression against a JSON object, returning a transformed result"
---

# JSONata

:iot-jsonata-lg:{style="font-size: 100px"}

This task evaluates a JSONata expression against a given JSON object.

## Workflows

| Data Flow | Control Flow |
| :--------: | :---------: |
| :material-check:{ style="color: #4DB6AC" } |  :material-close:{ style="color: #EF5350" } |

## Inputs

| Name         | Data Type | Description                                  |
| ------------ | --------- | ------------------------------------------- |
| value        | `Object`  | The JSON object                              |
| expression   | `String`  | The JSONata expression                       |
| Activate     | `Any`     | Activates the task execution                 |

## Outputs

| Name     | Data Type | Description                                                                         |
| -------- | --------- | ---------------------------------------------------------------------------------- |
| result   | `Object`  | The result of evaluating the JSONata expression against the JSON object             |
| Success  | `Boolean` | If there was no problem emits a true                                                |
| Error    | `Error`   | Error that occurred during the processing of this task                              |

## Settings

On the `General` Tab, you have the usual settings and the following options settings:

| Name          | Data Type | Description                                                  |
| ------------- | --------- | ------------------------------------------------------------ |
| Expression    | `String`  | The JSONata expression                                       |

## Behavior

The task evaluates a JSONata expression against a given JSON object to dynamically extract, transform or query specific data from the JSON object. The output of the task can be a filtered subset of the JSON data, a transformed version of it, or specific values extracted based on the expression's logic.