---
title: Manage tables
description: Tables in InfluxDB 3 Core are synonymous with measurements and contain time series data. Each table has a defined schema with tag and field columns.
url: https://docs.influxdata.com/influxdb3/core/admin/tables/
estimated_tokens: 2101
product: InfluxDB 3 Core
version: core
---

# Manage tables

Tables are synonymous with measurements in InfluxDB 3 Core. They are typically created automatically when you write line protocol data, but you can also manually create them to define custom schemas or apply settings. before writing data.

### [Create a table](/influxdb3/core/admin/tables/create/)

Use the influxdb3 CLI or HTTP API to create a table in a specified database in InfluxDB 3 Core.

```sh
# influxdb3 CLI
influxdb3 create table \
  --tags tag1,tag2,tag3 \
  --database DATABASE_NAME \
  --token AUTH_TOKEN \
  TABLE_NAME

# HTTP API
curl -X POST "http://localhost:8181/api/v3/configure/table" \
  --header "Authorization: Bearer AUTH_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"db": "DATABASE_NAME", "table": "TABLE_NAME", "tags": ["tag1", "tag2", "tag3"]}'
```

### [List tables](/influxdb3/core/admin/tables/list/)

Use the influxdb3 CLI or HTTP API to list tables in a specified database in InfluxDB 3 Core. Use SQL SHOW TABLES or InfluxQL SHOW MEASUREMENTS statements.

```sh
# influxdb3 CLI
influxdb3 query \
  --database DATABASE_NAME \
  --token AUTH_TOKEN \
  "SHOW TABLES"

# HTTP API
curl --get "http://localhost:8181/api/v3/query_sql" \
  --header "Authorization: Bearer AUTH_TOKEN" \
  --data-urlencode "db=DATABASE_NAME" \
  --data-urlencode "q=SHOW TABLES"
```

### [Delete a table](/influxdb3/core/admin/tables/delete/)

Use the [`influxdb3 delete table` command](/influxdb3/core/reference/cli/influxdb3/delete/table/) or the [HTTP API](/influxdb3/core/api/v3/) to delete a table from a specified database in InfluxDB 3 Core. Supports both soft delete and hard delete operations.

```sh
# CLI
influxdb3 delete table \
  --database <DATABASE_NAME> \
  --token <AUTH_TOKEN> \
  <TABLE_NAME>

# HTTP API
curl -X DELETE "http://localhost:8181/api/v3/configure/table?db=<DATABASE_NAME>&table=<TABLE_NAME>" \
  --header "Authorization: Bearer <AUTH_TOKEN>"
```

#### Related

-   [InfluxDB schema design recommendations](/influxdb3/core/write-data/best-practices/schema-design/)
-   [influxdb3 CLI](/influxdb3/core/reference/cli/influxdb3/)
-   [Naming restrictions and conventions](/influxdb3/core/reference/naming-restrictions/)

[tables](/influxdb3/core/tags/tables/)