> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Datasets
> Create, list, get, update, and delete datasets.
A dataset is a named container for your documents. You must create a dataset before uploading files into it.
## Create a dataset
When creating a dataset, you must specify a **region** — this determines where your data is physically stored.
Once set, a dataset's region cannot be changed. See [available regions](/regions).
```bash theme={null}
topk dataset create my-dataset --region aws-us-east-1-elastica
# (Optional) Dataset description can be also specified:
topk dataset create my-dataset --region aws-us-east-1-elastica --description "My dataset"
```
```python Sync theme={null}
client.datasets().create("my-docs")
# (Optional) Dataset description can be also specified:
client.datasets().create("my-docs", description="My dataset")
```
```python Async theme={null}
await client.datasets().create("my-docs")
# (Optional) Dataset description can be also specified:
await client.datasets().create("my-docs", description="My dataset")
```
```typescript theme={null}
await client.datasets().create("my-docs");
// (Optional) Dataset description can be also specified:
await client.datasets().create("my-docs", "My dataset");
```
## List datasets
```bash theme={null}
topk dataset list
```
```python Sync theme={null}
datasets = client.datasets().list()
for dataset in datasets:
print(dataset.name)
```
```python Async theme={null}
datasets = await client.datasets().list()
for dataset in datasets:
print(dataset.name)
```
```typescript theme={null}
const datasets = await client.datasets().list();
for (const dataset of datasets) {
console.log(dataset.name);
}
```
## Get a dataset
```bash theme={null}
topk dataset get my-docs
```
```python Sync theme={null}
dataset = client.datasets().get("my-docs")
print(dataset.name)
```
```python Async theme={null}
dataset = await client.datasets().get("my-docs")
print(dataset.name)
```
```typescript theme={null}
const dataset = await client.datasets().get("my-docs");
console.log(dataset.name);
```
## Update a dataset
Update dataset **description**:
```bash theme={null}
topk dataset update my-docs --description "Annual financial filings"
```
```python Sync theme={null}
dataset = client.datasets().update(
"my-docs",
description="Annual financial filings",
)
print(dataset.description)
```
```python Async theme={null}
dataset = await client.datasets().update(
"my-docs",
description="Annual financial filings",
)
print(dataset.description)
```
```typescript theme={null}
const dataset = await client.datasets().update("my-docs", {
description: "Annual financial filings",
});
console.log(dataset.description);
```
## Delete a dataset
Deleting a dataset is irreversible.
All documents stored in the dataset will be permanently removed.
```bash theme={null}
topk dataset delete --dataset my-docs
```
The CLI will prompt for confirmation. Use `-y` to skip:
```bash theme={null}
topk dataset delete --dataset my-docs -y
```
```python Sync theme={null}
client.datasets().delete("my-docs")
```
```python Async theme={null}
await client.datasets().delete("my-docs")
```
```typescript theme={null}
await client.datasets().delete("my-docs");
```