---
title: "PUT /table-record-expiration#tableArn"
method: PUT
path: "/table-record-expiration#tableArn"
---

# PUT /table-record-expiration#tableArn

`PUT /table-record-expiration#tableArn`

Creates or updates the expiration configuration settings for records in a table, including the status of the configuration. If you enable record expiration for a table, records expire and are automatically removed from the table after the number of days that you specify.

Permissions

You must have the `s3tables:PutTableRecordExpirationConfiguration` permission to use this operation.

## Query parameters

- `tableArn` string, required

## Request body

- object
  - `value` object, required — The expiration configuration settings for records in a table, and the status of the configuration. If the status of the configuration is enabled, records expire and are automatically removed after the number of days specified in the record expiration settings for the table.
    - `status` 'enabled' | 'disabled' — The status of the expiration settings for records in the table.
    - `settings` object — The expiration settings for records in the table.
      - `days` integer — If you enable record expiration for a table, you can specify the number of days to retain your table records. For example, to retain your table records for one year, set this value to <code>365</code>.

## Response `204`

Success

## Other responses

- `480` — InternalServerErrorException
- `481` — MethodNotAllowedException
- `482` — ForbiddenException
- `483` — NotFoundException
- `484` — TooManyRequestsException
- `485` — BadRequestException

---

[API](https://skmtc.net/aws/apis/s3tables.md) · [All operations](https://skmtc.net/aws/apis/s3tables/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/s3tables/versions/d7413f19d46e/schema)