---
title: "Rename a table"
method: POST
path: "/apis/iceberg/v1/{prefix}/tables/rename"
tags: ["Tables"]
---

# Rename a table

`POST /apis/iceberg/v1/{prefix}/tables/rename`

## Request

- The document declares no server URL.
- Auth: none declared

Rename a table from its current name to a new name

## Path parameters

- `prefix` string, required

## Request body

- RenameTableRequest
  - `source` TableIdentifier, required
    - `namespace` string[], required: A namespace identifier as an array of levels
    - `name` string, required: Table name
  - `destination` TableIdentifier, required
    - `namespace` string[], required: A namespace identifier as an array of levels
    - `name` string, required: Table name

## Response `204`

Table successfully renamed

## Other responses

- `404`: Not found
- `409`: Conflict - Resource already exists or namespace is not empty

---

[API](https://skmtc.dev/apicurio/apis/apache-iceberg-rest-catalog-api.md) - [All operations](https://skmtc.dev/apicurio/apis/apache-iceberg-rest-catalog-api/llms.txt) - [OpenAPI document](https://skmtc.dev/apicurio/apis/apache-iceberg-rest-catalog-api/revisions/76f2405494d1?raw)