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

# toString (object)

> Reference for the toString (object) workflow task, which converts a valid JSON value to a JSON string.

## Task purpose

The `toString (object)` task converts a valid JSON value to a JSON string, optionally replacing values if a replacer function is specified, or including only specified properties if a replacer array is specified.

## Potential use case

If a query into a ticketing database returns data as a JSON object, you could use this task to convert the object to a string and include it as the body of an email.

## Properties

| Incoming   | Type   | Description                                                                                                                                            |
| ---------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `value`    | \*     | Required. Any valid JSON value to convert to a string. The wildcard (`*`) represents any JSON value — for example, an object, array, or number.        |
| `replacer` | Array  | Optional. An array of String and Number objects that act as a whitelist, selecting which properties of the value object to include in the JSON string. |
| `space`    | Number | Optional. A number that inserts white space into the output JSON string for readability.                                                               |

| Outgoing      | Type   | Description                            |
| ------------- | ------ | -------------------------------------- |
| `stringified` | String | A string representation of the object. |

## Example

The input variable `value` is shown in Task History, accessible from Jobs in Operations Manager.

![](/_fern-img/5cb4f4dd5aa96dc12a46468c7f26627bacd781ee4aec1797d25088299eaa67f6.webp)

The output shows the stringified object. No white space is added since no `space` value was set.

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

> Reference for the toString (object) workflow task, which converts a valid JSON value to a JSON string.