> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-cloud/studio/tasks/reference/flatten-json-form-input/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# FlattenJSONFormInput

> Use the FlattenJSONFormInput task to convert single-value arrays into simple key-value pairs.

The `FlattenJSONFormInput` task converts the key-values of arrays that have a single value into simple key-value pairs.

## Potential use case

Suppose you have a dataset containing a cause-and-effect object expression and you want to break it down into two key-values that relate to each other. You can use `FlattenJSONFormInput` to convert the dataset expression and display the cause and effect as individual value pairs.

## Properties

| Incoming | Type   | Description                    |
| :------- | :----- | :----------------------------- |
| `input`  | Object | Required. The JSON to convert. |

| Outgoing   | Type   | Description            |
| :--------- | :----- | :--------------------- |
| `response` | Object | A JSON key-value pair. |

## Example

In this example, the `input` object expression is `{"test":["a"]}`.

![](/_fern-img/a13ec953b31bef04381cdac38e51a92dcef05720727fce843deb5fe118a5bf5e.webp)

The `response` returns as `{"test": "a"}` — a simple key-value pair.

![](/_fern-img/b9570151c5ee1722b7c149b8f6cf122969fabf52d9a77f7514ce77b06206434f.webp)

> Use the FlattenJSONFormInput task to convert single-value arrays into simple key-value pairs.