/

POST

Deletes a single item in a table by primary key. You can perform a conditional delete operation that deletes the item if it exists, or if it has an expected attribute value.

In addition to deleting an item, you can also return the item's attribute values in the same operation, using the ReturnValues parameter.

Unless you specify conditions, the DeleteItem is an idempotent operation; running it multiple times on the same item or attribute does not result in an error response.

Conditional deletes are useful for deleting items only if specific conditions are met. If those conditions are met, DynamoDB performs the delete. Otherwise, the item is not deleted.

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

{
    "ConsumedCapacity": {
        "CapacityUnits": 1,
        "TableName": "Music"
    }
}

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