# DynamoDB GetItem Action

It provides a way to get Item from DynamoDB. Before adding DynamoDB GetItem Action, user has to define a [**AWS Connection**](/connections/aws-connection.md). User need to provide following parameters to add DynamoDB GetItem Action.

#### TableName

User's DynamoDB Tablename

#### Function

*  JavaScript code to get "DynamoDB Item".
*  "payload" object and "params" object is available in this code. params object should hold key-value data pairs as mentioned in [AWS Doc](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#get-property). "payload" object is supplied from Action Trigger like Rules, Action Command etc.
* Any params passed through Function will override parameters passed through form.

#### Connection ID

Connection ID of AWS Connection.

#### Key

User can provide a primary key here. Check [AWS Doc](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#get-property) for more information.

#### ProjectionExpression

User can provide a ProjectionExpression here. Check [AWS Doc](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#get-property) for more information.

#### ExpressionAttributeNames

User can provide a ExpressionAttributeValues here. Check [AWS Doc](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#get-property) for more information.

```
//"id" and "name" are the column names inside DynamoDB table.
//It contains a entry having id=2 and name="abc"
//Following is the field you need mention in form to get the entries from table id having value 2.

{"id":"2"}  //key
```

![Add DynamoDB GetItem Action](/files/CRn73hdLaz0lzo9cY7vD)

Please note the following points:

{% hint style="info" %}

* "payload" object is supplied from Action Trigger like Rules, Action Command etc.
* Data Response of GetItem will be available as Action Response.
  {% endhint %}


---

# 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.thingsup.io/actions/dynamodb-getitem-action.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.