---
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`

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.net/apicurio/apis/apache-iceberg-rest-catalog-api.md) · [All operations](https://skmtc.net/apicurio/apis/apache-iceberg-rest-catalog-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apicurio/apache-iceberg-rest-catalog-api/revisions/76f2405494d1/schema)