/

POST

Edits an existing item's attributes, or adds a new item to the table if it does not already exist. You can put, delete, or add attribute values. You can also perform a conditional update on an existing item (insert a new attribute name-value pair if it doesn't exist, or replace an existing name-value pair if it has certain expected attribute values).

You can also return the item's attribute values in the same UpdateItem operation using the ReturnValues parameter.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠480ConditionalCheckFailedException

🟠481ProvisionedThroughputExceededException

🟠482ResourceNotFoundException

🟠483ItemCollectionSizeLimitExceededException

🟠484TransactionConflictException

🟠485RequestLimitExceeded

🟠486InternalServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/' \
--header 'X-Amz-Target;' \
--header 'Content-Type: application/json' \
--data-raw ''

Response Example

200 - Example 1

{
    "Attributes": {
        "AlbumTitle": {
            "S": "Louder Than Ever"
        },
        "Artist": {
            "S": "Acme Band"
        },
        "SongTitle": {
            "S": "Happy Day"
        },
        "Year": {
            "N": "2015"
        }
    }
}

Modified at 2023-08-22 09:04:07