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

# Datasets

> Manage datasets (FHIR bundles, file sets).

Manage datasets containing patient records, FHIR bundles, or file sets that populate simulators.

## Actions

| Action   | Description                           |
| -------- | ------------------------------------- |
| `list`   | List all datasets in the organization |
| `create` | Create a new dataset                  |
| `get`    | Get a dataset by ID                   |
| `update` | Update a dataset                      |
| `delete` | Delete a dataset                      |

## Parameters

### `list`

No parameters.

### `create`

| Parameter     | Type    | Required | Description                                           |
| ------------- | ------- | -------- | ----------------------------------------------------- |
| `name`        | string  | yes      | Name of the dataset                                   |
| `description` | string  | no       | Description of the dataset                            |
| `type`        | string  | no       | Dataset type: `FHIR` or `Files`                       |
| `data`        | unknown | no       | Dataset contents (FHIR bundle, file references, etc.) |
| `config`      | object  | no       | Dataset configuration                                 |

### `get`

| Parameter | Type   | Required | Description |
| --------- | ------ | -------- | ----------- |
| `id`      | string | yes      | Dataset ID  |

### `update`

| Parameter     | Type           | Required | Description                           |
| ------------- | -------------- | -------- | ------------------------------------- |
| `id`          | string         | yes      | Dataset ID                            |
| `name`        | string         | no       | Updated name                          |
| `description` | string \| null | no       | Updated description, or null to clear |
| `data`        | unknown        | no       | Updated dataset contents              |
| `config`      | object \| null | no       | Updated config, or null to clear      |

### `delete`

| Parameter | Type   | Required | Description |
| --------- | ------ | -------- | ----------- |
| `id`      | string | yes      | Dataset ID  |

## Examples

### Create a FHIR patient dataset

```json theme={null}
{
  "action": "create",
  "name": "Prior Auth Patients",
  "description": "Patients requiring prior authorization for imaging",
  "type": "FHIR",
  "data": {
    "resourceType": "Bundle",
    "type": "collection",
    "entry": [
      {
        "resource": {
          "resourceType": "Patient",
          "name": [{ "family": "Chen", "given": ["Maria"] }],
          "birthDate": "1985-03-14"
        }
      }
    ]
  }
}
```

### List all datasets

```json theme={null}
{
  "action": "list"
}
```

### Get a dataset by ID

```json theme={null}
{
  "action": "get",
  "id": "ds_abc123"
}
```