> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognee.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Dataset Management

> Endpoints for creating, listing, and managing datasets

Datasets are the organizational unit for all data in Cognee Cloud. Each dataset maintains its own knowledge graph and vector store. See [Datasets](/core-concepts/further-concepts/datasets) for the underlying concept.

## List datasets

**`GET /api/v1/datasets/`** — List all datasets accessible to the authenticated user.

```bash theme={null}
curl https://your-tenant.aws.cognee.ai/api/v1/datasets/ \
  -H "X-Api-Key: your-key"
```

## Create a dataset

**`POST /api/v1/datasets/`** — Create a new dataset or return the existing one if the name already exists.

```bash theme={null}
curl -X POST https://your-tenant.aws.cognee.ai/api/v1/datasets/ \
  -H "X-Api-Key: your-key" \
  -H "Content-Type: application/json" \
  -d '{"name": "my_dataset"}'
```

<Note>
  Datasets are also created implicitly when you call `add` or `remember` with a `dataset_name` that does not yet exist.
</Note>

## Dataset status

**`GET /api/v1/datasets/status`** — Get the processing status of all datasets.

Returns the pipeline state for each dataset: whether cognify is pending, running, or completed.

## Dataset data

**`GET /api/v1/datasets/{dataset_id}/data`** — List all data items in a dataset.

**`GET /api/v1/datasets/{dataset_id}/data/{data_id}/raw`** — Download the original file for a specific data item.

## Delete

**`DELETE /api/v1/datasets/{dataset_id}`** — Delete a dataset and all its contents.

**`DELETE /api/v1/datasets/{dataset_id}/data/{data_id}`** — Delete a specific data item from a dataset.

<Warning>
  Deleting a dataset removes all associated documents, knowledge graph data, and embeddings. This cannot be undone.
</Warning>