---
title: "PUT /table-replication#tableArn"
method: PUT
path: "/table-replication#tableArn"
---

# PUT /table-replication#tableArn

`PUT /table-replication#tableArn`

Creates or updates the replication configuration for a specific table. This operation allows you to define table-level replication independently of bucket-level replication, providing granular control over which tables are replicated and where.

Permissions

*   You must have the `s3tables:PutTableReplication` permission to use this operation. The IAM role specified in the configuration must have permissions to read from the source table and write to all destination tables.
    
*   You must also have the following permissions:
    
    *   `s3tables:GetTable` permission on the source table being replicated.
        
    *   `s3tables:CreateTable` permission for the destination.
        
    *   `s3tables:CreateNamespace` permission for the destination.
        
    *   `s3tables:GetTableMaintenanceConfig` permission for the source table.
        
    *   `s3tables:PutTableMaintenanceConfig` permission for the destination table.
        
*   You must have `iam:PassRole` permission with condition allowing roles to be passed to `replication.s3tables.amazonaws.com`.

## Query parameters

- `tableArn` string, required
- `versionToken` string

## Request body

- object
  - `configuration` object, required — The replication configuration for an individual table. This configuration defines how the table is replicated to destination tables.
    - `role` string — The Amazon Resource Name (ARN) of the IAM role that S3 Tables assumes to replicate the table on your behalf.
    - `rules` TableReplicationRule[] — An array of replication rules that define where this table should be replicated.
      - `destinations` ReplicationDestination[], required — An array of destination table buckets where this table should be replicated.
        - `destinationTableBucketARN` string, required — The Amazon Resource Name (ARN) of the destination table bucket where tables will be replicated.

## Response `200`

Success

- PutTableReplicationResponse
  - `versionToken` string, required — A new version token representing the updated replication configuration.
  - `status` string, required — The status of the replication configuration operation.

## Other responses

- `480` — InternalServerErrorException
- `481` — ForbiddenException
- `482` — NotFoundException
- `483` — AccessDeniedException
- `484` — TooManyRequestsException
- `485` — ConflictException
- `486` — 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)