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

# Task reference overview

> A library of Itential task references to help you design and manage workflows in Itential Platform.

This section contains a library of Itential task references to help you design and manage your workflows. Each task performs a different activity within a workflow to support automation and orchestration on remote system services, servers, devices, and applications.

Although this library is designed to help you scale and work more productively, we recommend having a basic understanding of [workflow best practices](/itential-platform/studio/workflows/best-practices) to use each task effectively.

**Task references**

The table below lists every task in the reference library along with a brief description. Click a task name to open the full reference page.

| Task                                                                                      | Description                                                                                                                                       |
| ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| [addDuration](/itential-platform/studio/tasks/reference/add-duration-time)                | Use the addDuration task to add a duration to an existing timestamp and return the adjusted time.                                                 |
| [arrayIncludes](/itential-platform/studio/tasks/reference/array-includes)                 | Use the arrayIncludes task to determine whether an array contains a given element.                                                                |
| [assign](/itential-platform/studio/tasks/reference/assign)                                | Copies enumerable properties from a source object to a target object                                                                              |
| [indexOf (array)](/itential-platform/studio/tasks/reference/array-index-of)               | Use the indexOf task to find the first index position of an element in an array.                                                                  |
| [arrayLastIndexOf](/itential-platform/studio/tasks/reference/array-last-index-of)         | Use the arrayLastIndexOf task to find the last index position of an element in an array.                                                          |
| [arrayToString](/itential-platform/studio/tasks/reference/array-to-string)                | Use the arrayToString task to return a string representing the contents of an array.                                                              |
| [calculateTimeDiff](/itential-platform/studio/tasks/reference/calculate-time-diff)        | Use the calculateTimeDiff task to calculate the difference between two timestamps and return the result as a duration.                            |
| [charAt](/itential-platform/studio/tasks/reference/char-at)                               | Use the charAt task to return the character at a given index position in a string.                                                                |
| [charCodeAt](/itential-platform/studio/tasks/reference/char-code-at)                      | Use the charCodeAt task to obtain the Unicode decimal (UTF-16) value for a character at a specific position in a string.                          |
| [childjob](/itential-platform/studio/tasks/reference/childjob)                            | Use the childjob task to run a separate workflow as a child job, enabling workflow reuse and parallel or sequential looping.                      |
| [codePointAt](/itential-platform/studio/tasks/reference/code-poin-tat)                    | Use the codePointAt task to retrieve the Unicode code point value of a character at a specific position in a string.                              |
| [concat](/itential-platform/studio/tasks/reference/concat)                                | Concatenates strings or arrays of strings.                                                                                                        |
| [concatArray](/itential-platform/studio/tasks/reference/concat-array)                     | Use the concatArray task to combine the elements of two arrays into a new array.                                                                  |
| [convertEpochToObject](/itential-platform/studio/tasks/reference/convert-epoch-to-object) | Use the convertEpochToObject task to convert an Epoch timestamp into a human-readable date string with a specified time and date format.          |
| [convertTimeFormat](/itential-platform/studio/tasks/reference/convert-time-format)        | Use the convertTimeFormat task to convert a time value into a new moment.js format string.                                                        |
| [convertTimeToEpoch](/itential-platform/studio/tasks/reference/convert-time-to-epoch)     | Use the convertTimeToEpoch task to convert a date/timestamp to Epoch Time.                                                                        |
| [convertTimezone](/itential-platform/studio/tasks/reference/converttimezone)              | Use the convertTimezone task to offset a timestamp by a specified number of whole hours.                                                          |
| [copyWithin](/itential-platform/studio/tasks/reference/copy-within)                       | Use the copyWithin task to copy a portion of an array to a new location within the same array without modifying its size.                         |
| [csvStringToJSON](/itential-platform/studio/tasks/reference/csv-to-json-task)             | Use the csvStringToJSON task to convert a CSV string to JSON format.                                                                              |
| [deepmerge](/itential-platform/studio/tasks/reference/deepmerge)                          | Folds two or more objects together into a single object, merging at any depth.                                                                    |
| [delay](/itential-platform/studio/tasks/reference/delay)                                  | Use the delay task to pause a job for a specified number of seconds.                                                                              |
| [endsWith](/itential-platform/studio/tasks/reference/ends-with)                           | Use the endsWith task to determine whether a string ends with a specified sequence of characters.                                                 |
| [ErrorHandling](/itential-platform/studio/tasks/reference/error-handling)                 | Use the ErrorHandling task to manage error severity levels and control workflow flow in response to fatal errors, warnings, or successful states. |
| [evaluation](/itential-platform/studio/tasks/reference/evaluation)                        | Controls execution paths by comparing values at runtime using configurable operators and evaluation groups.                                       |
| [eventListenerJob](/itential-platform/studio/tasks/reference/event-listener-job)          | Pauses a workflow and waits for an event matching a specified topic and schema.                                                                   |
| [exceltojson](/itential-platform/studio/tasks/reference/excel-to-json)                    | Use the exceltojson task to convert a Base64-encoded Excel file to JSON format.                                                                   |
| [extractField](/itential-platform/studio/tasks/reference/extract-field)                   | Use the extractField task to extract a specific time field such as day, month, or year from a timestamp.                                          |
| [fill](/itential-platform/studio/tasks/reference/fill)                                    | Fills the elements of an array with a static value from optional start and end positions.                                                         |
| [FlattenJSONFormInput](/itential-platform/studio/tasks/reference/flatten-json-form-input) | Use the FlattenJSONFormInput task to convert single-value arrays into simple key-value pairs.                                                     |
| [forEach](/itential-cloud/studio/tasks/reference/for-each)                                | Use the forEach task to execute a loop inside a job, iterating over an array and running a series of tasks for each element.                      |
| [getTime](/itential-platform/studio/tasks/reference/get-time)                             | Use the getTime task to obtain a current timestamp for use in a workflow, with an optional offset.                                                |
| [includes](/itential-platform/studio/tasks/reference/includes)                            | Searches a string for a specified value and returns true or false.                                                                                |
| [indexOf](/itential-platform/studio/tasks/reference/indexof)                              | Use the indexOf task to find the position of a specific character or group of characters within a string.                                         |
| [interactiveHTML](/itential-platform/studio/tasks/reference/interactive-html)             | Renders custom HTML and CSS, and returns operator input as output variables. Platform 6.5.2+                                                      |
| [isArray](/itential-platform/studio/tasks/reference/is-array)                             | Checks whether an input is an array and returns true or false.                                                                                    |
| [join](/itential-platform/studio/tasks/reference/join)                                    | Use the join task to join all elements of an array into a single string.                                                                          |
| [keys](/itential-platform/studio/tasks/reference/keys)                                    | Use the keys (object) task to return an array of key names from an object, preserving the original order.                                         |
| [lastIndexOf](/itential-platform/studio/tasks/reference/last-index-of)                    | Use the lastIndexOf task to identify the last occurrence of a character or group of characters within a string by searching backwards.            |
| [length (array)](/itential-platform/studio/tasks/reference/length)                        | Use the length task to return the number of elements in a given array.                                                                            |
| [length (string)](/itential-platform/studio/tasks/reference/length-string)                | Use the length (string) task to count the number of characters in a string.                                                                       |
| [localeCompare](/itential-platform/studio/tasks/reference/locale-compare)                 | Use the localeCompare task to compare two strings in the current locale and return a numeric sort-order result.                                   |
| [makeData](/itential-platform/studio/tasks/reference/make-data)                           | Use the makeData task to convert an input string into a different data type.                                                                      |
| [map](/itential-platform/studio/tasks/reference/map)                                      | Use the map task to map an input array to an array of values, producing key-value pairs.                                                          |
| [match](/itential-platform/studio/tasks/reference/match)                                  | Use the match task to find regex matches in a string and return results as an array.                                                              |
| [merge](/itential-platform/studio/tasks/reference/merge)                                  | Combines data from job variables, static data, and task outgoing variables into a new variable using no-key or unique-key assignment modes.       |
| [modify](/itential-platform/studio/tasks/reference/modify)                                | Creates a new variable from a modified copy of an existing variable by updating boolean, number, or string values.                                |
| [normalize](/itential-platform/studio/tasks/reference/normalize)                          | Returns a string in a specified Unicode normalization form.                                                                                       |
| [newVariable](/itential-platform/studio/tasks/reference/new-variable)                     | Use the newVariable task to create a new job variable of type boolean, number, string, object, or array.                                          |
| [toString](/itential-platform/studio/tasks/reference/number-to-string)                    | Use the toString task to convert a number into its string representation.                                                                         |
| [objectHasOwnProperty](/itential-platform/studio/tasks/reference/object-has-own-property) | Use the objectHasOwnProperty task to check whether an object has a specified property as its own property, returning a boolean result.            |
| [objectToString](/itential-platform/studio/tasks/reference/object-to-string)              | Use the objectToString task to convert a valid JSON value to a JSON string.                                                                       |
| [padEnd](/itential-platform/studio/tasks/reference/pad-end)                               | Pads the end of a string with another string until the result reaches a specified length.                                                         |
| [padStart](/itential-platform/studio/tasks/reference/pad-start)                           | Use the padStart task to pad a string with a specified string at the start until it reaches a given length.                                       |
| [parseInt](/itential-platform/studio/tasks/reference/parse-int)                           | Use the parseInt task to parse a string value and return an integer using the decimal number system as a base.                                    |
| [parse](/itential-platform/studio/tasks/reference/parse)                                  | Use the parse task to parse a JSON string and return a JavaScript object.                                                                         |
| [pop](/itential-platform/studio/tasks/reference/pop)                                      | Removes the last item from a job array variable and returns it.                                                                                   |
| [popFromArray](/itential-platform/studio/tasks/reference/array-pop)                       | Use the popFromArray task to remove the last element from a job array variable and return the removed item.                                       |
| [pushToArray](/itential-platform/studio/tasks/reference/push-to-array)                    | Use the pushToArray task to add an element to a job array variable during workflow execution.                                                     |
| [push](/itential-platform/studio/tasks/reference/push)                                    | Use the push (array) task to add an element to the end of an array.                                                                               |
| [query](/itential-platform/studio/tasks/reference/query)                                  | Use the query task to extract and reshape data from object variables for use with existing tasks.                                                 |
| [Quick Form](/itential-platform/studio/tasks/reference/quick-form)                        | Renders array data as a table and optionally collects input through an action column. Platform 6.5.0+                                             |
| [repeat](/itential-platform/studio/tasks/reference/repeat)                                | Use the repeat task to copy a string a specified number of times and concatenate the copies into a new string.                                    |
| [restCall](/itential-platform/studio/tasks/reference/restcall)                            | Use the restCall to make HTTP requests to external API data sources.                                                                              |
| [reverse](/itential-platform/studio/tasks/reference/reverse)                              | Use the restCall to make HTTP requests to external API data sources.                                                                              |
| [runAgent](/itential-platform/studio/tasks/reference/run-agent)                           | Invokes an agent from a workflow canvas. Platform 6.5+                                                                                            |
| [runCode](/itential-platform/studio/tasks/reference/run-code)                             | Executes a Python script within a workflow. Platform 6.4+                                                                                         |
| [search](/itential-platform/studio/tasks/reference/search)                                | Use the search (string) task to find the index of the first regular expression match in a string.                                                 |
| [setObjectKey](/itential-platform/studio/tasks/reference/set-object-key)                  | Use the setObjectKey task to set a property value on an object by specifying a path, creating the path if it does not exist.                      |
| [shift](/itential-platform/studio/tasks/reference/shift)                                  | Removes the first element from an array and returns the shortened array.                                                                          |
| [slice](/itential-platform/studio/tasks/reference/slice-array)                            | Use the slice (string) task to extract part of a string and return it as a new string.                                                            |
| [slice-string](/itential-platform/studio/tasks/reference/slice-string)                    | Extracts part of a string between specified start and end indexes.                                                                                |
| [sort](/itential-platform/studio/tasks/reference/sort)                                    | Sorts the elements of an array in ascending or descending order.                                                                                  |
| [split](/itential-platform/studio/tasks/reference/split)                                  | Use the split task to split a string into an array of substrings using a separator.                                                               |
| [startsWith](/itential-platform/studio/tasks/reference/starts-with)                       | Use the startsWith task to determine whether a string begins with a specified set of characters.                                                  |
| [stringValueOf](/itential-platform/studio/tasks/reference/string-value-of)                | Use the stringValueOf task to return the primitive value of a string object as a string data type.                                                |
| [stub](/itential-platform/studio/tasks/reference/stub)                                    | Use the stub task as a placeholder in a workflow to represent tasks that have not yet been implemented.                                           |
| [substring](/itential-platform/studio/tasks/reference/substring)                          | Use the substring task to extract a sequence of characters from a string between a start and end index.                                           |
| [toLocaleLowerCase](/itential-platform/studio/tasks/reference/to-locale-lowercase)        | Use the toLocaleLowerCase task to convert a string to lowercase according to locale-specific case mappings.                                       |
| [toLocaleString](/itential-platform/studio/tasks/reference/to-locale-string)              | Use the toLocaleString task to convert array elements to a locale-specific string.                                                                |
| [toLocaleUpperCase](/itential-platform/studio/tasks/reference/to-locale-uppercase)        | Use the toLocaleUpperCase task to convert a string to uppercase according to locale-specific case mappings.                                       |
| [toLowerCase](/itential-platform/studio/tasks/reference/to-lowercase)                     | Use the toLowerCase task to convert all characters of a string to lowercase.                                                                      |
| [toString (array)](/itential-platform/studio/tasks/reference/to-string-array)             | Returns a string representing the contents of an array with elements separated by commas.                                                         |
| [toString (number)](/itential-platform/studio/tasks/reference/to-string-number)           | Converts a number to its string representation.                                                                                                   |
| [toString (object)](/itential-platform/studio/tasks/reference/to-string-object)           | converts a valid JSON value to a JSON string.                                                                                                     |
| [toUpperCase](/itential-platform/studio/tasks/reference/to-uppercase)                     | Use the toUpperCase task to convert all characters in a string to uppercase.                                                                      |
| [transformation](/itential-platform/studio/tasks/reference/transformation)                | Use the transformation task to run JSON Schema Transformations (JSTs) during workflow job execution.                                              |
| [trim](/itential-platform/studio/tasks/reference/trim)                                    | Use the trim task to remove whitespace from both ends of a string.                                                                                |
| [trimEnd](/itential-platform/studio/tasks/reference/trim-end)                             | Use the trimEnd task to remove whitespace from the end of a string.                                                                               |
| [trimStart](/itential-platform/studio/tasks/reference/trim-start)                         | Use the trimStart task to remove whitespace from the beginning of a string.                                                                       |
| [unshift](/itential-platform/studio/tasks/reference/unshift)                              | Use the unshift task to add an element to the beginning of an array.                                                                              |
| [updateJobDescription](/itential-platform/studio/tasks/reference/update-job-description)  | Use the updateJobDescription task to update a job's description while the job is running.                                                         |
| [values](/itential-platform/studio/tasks/reference/values)                                | Use the values task to return an array of the enumerable property values of an object.                                                            |
| [viewData](/itential-platform/studio/tasks/reference/viewdata)                            | Use the viewData task to display a form to users containing job data and enable decision-making for the next workflow step.                       |