# Retrieve Item

### Overview

This procedure retrieves a specific item from a department box *(a storage unit within an agent)*. If the item does not exist, this procedure offers the option to create a new record with an empty value or to skip the retrieval.

### Syntax

Below is a line-by-line overview of the automation syntax. Expand each line to learn more.

<details>

<summary><code>x is a department box</code></summary>

#### What does it do?

Specifies a department box.

#### Where does it go?

This phrase should be written on a **new line**.

#### Is it required?

✅ Yes — This phrase is **required**.

#### Does it require data?

✅ Yes — Replace **x** with the department box's name *(in plural form)*.

#### Example

```
Movies is a department box
```

</details>

<details>

<summary><code>the department box's engine is x</code></summary>

#### What does it do?

Specifies the engine used for the department box. Options include: **Amazon S3** for large or unstructured data, **Amazon DynamoDB** for fast key-value lookups, and **Amazon OpenSearch** for advanced search and filtering capabilities.

#### Where does it go?

This phrase should be written on a **new line**.

#### Is it required?

❌ No — This phrase is **optional**.

#### Does it require data?

✅ Yes — Replace **x** with one of the following values: `s3`, `dynamodb`, `opensearch`. The default is `s3`.

#### Example

```
the department box's engine is "dynamodb"
```

</details>

<details>

<summary><code>export x</code></summary>

#### What does it do?

Exports the department box to get the data.

#### Where does it go?

This phrase should be written on a **new line**.

#### Is it required?

✅ Yes — This phrase is **required**.

#### Does it require data?

✅ Yes — Replace **x** with the department box's name *(in plural form)*.

#### Example

```
export Movies
```

</details>

<details>

<summary><code>retrieve the item from {the department box} whose key is like "x"</code></summary>

#### What does it do?

Specifies a record to retrieve from a department box with a specific key.

#### Where does it go?

This phrase should be written on a **new line**.

#### Is it required?

✅ Yes — This phrase is **required**.

#### Does it require data?

✅ Yes — Replace **the department box** with the name of the department box. Replace **x** with a text value or reference that specifies the key.

#### Example

```
retrieve the item from Movies whose key is like "The Matrix"
```

</details>

<details>

<summary><code>retrieve "x" from {the department box}</code></summary>

#### What does it do?

Retrieves the actual value at the key from the department box.

#### Where does it go?

This phrase should be written on a **new line**.

#### Is it required?

✅ Yes — This phrase is **required**.

#### Does it require data?

✅ Yes — Replace **x** with the key. Replace **the department box** with the name of the department box.

#### Example

```
retrieve "The Matrix" from Movies
```

</details>

### Examples

#### 1. Example 1

This command retrieves the item with the key "announcement" from the HR department box.

```
Movies is a department box
export Movies
retrieve the item from HR whose key is like "The Matrix"
retrieve "The Matrix" from Movies
```

#### 2. Example 2

```
employees is a department box
the department box's engine is "s3"
export employees
retrieve the item from employees whose key is like "ID:123456"
retrieve "ID:123456" from employees
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kognitos.com/legacy/legacy-experience/automation-areas/department-box/retrieve-item.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.