> 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/keys/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# keys

> Use the keys (object) task to return an array of key names from an object, preserving the original order.

The `keys` task accepts an object that contains key/value pairs and returns an array that contains the `key` field information only, in the same order as it was presented by the original object. JSON formatted content is an object, and therefore a highly suited use case.

## Potential use case

Use this task if you need to build a form that displays `key` names of an object as labels on the form.

## Properties

| Incoming | Type   | Description                                                                    |
| -------- | ------ | ------------------------------------------------------------------------------ |
| `obj`    | Object | Required. The object from which the key names should be converted to an array. |

| Outgoing | Type  | Description                                    |
| -------- | ----- | ---------------------------------------------- |
| `keys`   | Array | The key names found within the `obj` variable. |

## Example

In this example, the `obj` value is statically set to:

```json
{
  "success": true,
  "deck_id": "bybjeupe9ymb",
  "remaining": 52,
  "shuffled": true
}
```

![](/_fern-img/00b290c6fc83361db18578e8b8431e57cf067fd8845c9d43571f71803c552281.webp)

This sample content was obtained via the `GET/restCall` task applied to the [Deck of Cards API](https://deckofcardsapi.com/api/deck/new/shuffle/?deck_count=1).

The outgoing `keys` value will be an array with the following contents:

```json
[
  "success",
  "deck_id",
  "remaining",
  "shuffled"
]
```

> Use the keys (object) task to return an array of key names from an object, preserving the original order.