---
title: Tables
description: Manage tables in an InfluxDB 3 Clustered database, including creating tables with custom column schemas.
url: https://docs.influxdata.com/influxdb3/clustered/api/management-api/tables/
estimated_tokens: 1290
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/clustered/api/management-api/tables/
---

[Download Clustered Management API Spec](/openapi/influxdb-clustered-management-api.yml)

Manage tables in an InfluxDB 3 Clustered database, including creating tables with custom column schemas.

POST`/databases/{databaseName}/tables`

### Create a database table

#### Parameters

##### Path parameters

`databaseName`requiredstring

The name of the database to create the database table for

#### Request bodyrequired

Content-Type:`application/json`

`name`requiredstring

`partitionTemplate`string

Example request[Ask AI about this](#)

```sh
curl --request POST \
  "https://console.influxdata.com/api/v0/databases/{databaseName}/tables" \
  --header "Authorization: Bearer INFLUX_TOKEN" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "name": "NAME",
  "partitionTemplate": []
}'
```

#### Responses

200The cluster database table was successfully created

`databaseName`requiredstring

The name of the database that the database table belongs to

`name`requiredstring

The name of the database table

`partitionTemplate`string

400Bad Request

`code`requiredinteger

`message`requiredstring

401Unauthorized

`code`requiredinteger

`message`requiredstring

403Forbidden

`code`requiredinteger

`message`requiredstring

404Not Found

`code`requiredinteger

`message`requiredstring

409Conflict

`code`requiredinteger

`message`requiredstring

500Internal Server Error

`code`requiredinteger

`message`requiredstring

PUT`/databases/{databaseName}/tables/{tableId}/undelete`

### Undelete a database table

Restores a previously deleted database table.

This operation can only be performed on tables that have been soft-deleted and are still within the recovery window.

#### Parameters

##### Path parameters

`databaseName`requiredstring

The name of the database that the table belongs to

`tableId`requiredinteger \<int64\>

The ID of the table to undelete

Example request[Ask AI about this](#)

```sh
curl --request PUT \
  "https://console.influxdata.com/api/v0/databases/{databaseName}/tables/{tableId}/undelete" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200The cluster database table was successfully undeleted

`databaseName`requiredstring

The name of the database that the table belongs to

`id`requiredinteger \<int64\>

The ID of the table

`name`requiredstring

The name of the table

`partitionTemplate`string

400Bad Request

`code`requiredinteger

`message`requiredstring

401Unauthorized

`code`requiredinteger

`message`requiredstring

403Forbidden

`code`requiredinteger

`message`requiredstring

404Not Found

`code`requiredinteger

`message`requiredstring

500Internal Server Error

`code`requiredinteger

`message`requiredstring

DELETE`/databases/{databaseName}/tables/{tableName}`

### Delete a database table

#### Parameters

##### Path parameters

`databaseName`requiredstring

The name of the database that the database table belongs to

`tableName`requiredstring

The name of the database table to delete

Example request[Ask AI about this](#)

```sh
curl --request DELETE \
  "https://console.influxdata.com/api/v0/databases/{databaseName}/tables/{tableName}" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

204The cluster database table was successfully deleted

400Bad Request

`code`requiredinteger

`message`requiredstring

401Unauthorized

`code`requiredinteger

`message`requiredstring

403Forbidden

`code`requiredinteger

`message`requiredstring

404Not Found

`code`requiredinteger

`message`requiredstring

500Internal Server Error

`code`requiredinteger

`message`requiredstring

PUT`/databases/{databaseName}/tables/{tableName}/rename`

### Rename a database table

#### Parameters

##### Path parameters

`databaseName`requiredstring

The name of the database that the database table belongs to

`tableName`requiredstring

The name of the database table to rename

#### Request bodyrequired

Content-Type:`application/json`

`name`requiredstring

Example request[Ask AI about this](#)

```sh
curl --request PUT \
  "https://console.influxdata.com/api/v0/databases/{databaseName}/tables/{tableName}/rename" \
  --header "Authorization: Bearer INFLUX_TOKEN" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "name": "NAME"
}'
```

#### Responses

200The cluster database table was successfully renamed

`databaseName`requiredstring

The name of the database that the table belongs to

`id`requiredinteger \<int64\>

The ID of the table

`name`requiredstring

The name of the table

`partitionTemplate`string

400Bad Request

`code`requiredinteger

`message`requiredstring

401Unauthorized

`code`requiredinteger

`message`requiredstring

403Forbidden

`code`requiredinteger

`message`requiredstring

404Not Found

`code`requiredinteger

`message`requiredstring

409Conflict

`code`requiredinteger

`message`requiredstring

500Internal Server Error

`code`requiredinteger

`message`requiredstring

#### Related

* [Manage tables](/influxdb3/clustered/admin/tables/)
* [Custom partitions](/influxdb3/clustered/admin/custom-partitions/)
* [InfluxDB 3 API client libraries](/influxdb3/clustered/reference/client-libraries/v3/)