# Datasets

## List Datasets

`client.aiGateway.datasets.list(stringgatewayId, DatasetListParamsparams, RequestOptionsoptions?): V4PagePaginationArray<DatasetListResponse>`

**get** `/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/datasets`

Lists all AI Gateway evaluator types configured for the account.

### Parameters

- `gatewayId: string`

  gateway id

- `params: DatasetListParams`

  - `account_id: string`

    Path param

  - `enable?: boolean`

    Query param

  - `name?: string`

    Query param

  - `page?: number`

    Query param

  - `per_page?: number`

    Query param

  - `search?: string`

    Query param: Search by id, name, filters

### Returns

- `DatasetListResponse`

  - `id: string`

  - `created_at: string`

  - `enable: boolean`

  - `filters: Array<Filter>`

    - `key: "created_at" | "request_content_type" | "response_content_type" | 10 more`

      - `"created_at"`

      - `"request_content_type"`

      - `"response_content_type"`

      - `"success"`

      - `"cached"`

      - `"provider"`

      - `"model"`

      - `"cost"`

      - `"tokens"`

      - `"tokens_in"`

      - `"tokens_out"`

      - `"duration"`

      - `"feedback"`

    - `operator: "eq" | "contains" | "lt" | "gt"`

      - `"eq"`

      - `"contains"`

      - `"lt"`

      - `"gt"`

    - `value: Array<string | number | boolean>`

      - `string`

      - `number`

      - `boolean`

  - `gateway_id: string`

    gateway id

  - `modified_at: string`

  - `name: string`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const datasetListResponse of client.aiGateway.datasets.list('my-gateway', {
  account_id: '3ebbcb006d4d46d7bb6a8c7f14676cb0',
})) {
  console.log(datasetListResponse.id);
}
```

#### Response

```json
{
  "result": [
    {
      "id": "id",
      "created_at": "2019-12-27T18:11:19.117Z",
      "enable": true,
      "filters": [
        {
          "key": "created_at",
          "operator": "eq",
          "value": [
            "string"
          ]
        }
      ],
      "gateway_id": "my-gateway",
      "modified_at": "2019-12-27T18:11:19.117Z",
      "name": "name"
    }
  ],
  "success": true
}
```

## Fetch a Dataset

`client.aiGateway.datasets.get(stringgatewayId, stringid, DatasetGetParamsparams, RequestOptionsoptions?): DatasetGetResponse`

**get** `/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/datasets/{id}`

Retrieves details for a specific AI Gateway dataset.

### Parameters

- `gatewayId: string`

  gateway id

- `id: string`

- `params: DatasetGetParams`

  - `account_id: string`

### Returns

- `DatasetGetResponse`

  - `id: string`

  - `created_at: string`

  - `enable: boolean`

  - `filters: Array<Filter>`

    - `key: "created_at" | "request_content_type" | "response_content_type" | 10 more`

      - `"created_at"`

      - `"request_content_type"`

      - `"response_content_type"`

      - `"success"`

      - `"cached"`

      - `"provider"`

      - `"model"`

      - `"cost"`

      - `"tokens"`

      - `"tokens_in"`

      - `"tokens_out"`

      - `"duration"`

      - `"feedback"`

    - `operator: "eq" | "contains" | "lt" | "gt"`

      - `"eq"`

      - `"contains"`

      - `"lt"`

      - `"gt"`

    - `value: Array<string | number | boolean>`

      - `string`

      - `number`

      - `boolean`

  - `gateway_id: string`

    gateway id

  - `modified_at: string`

  - `name: string`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const dataset = await client.aiGateway.datasets.get('my-gateway', 'id', {
  account_id: '3ebbcb006d4d46d7bb6a8c7f14676cb0',
});

console.log(dataset.id);
```

#### Response

```json
{
  "result": {
    "id": "id",
    "created_at": "2019-12-27T18:11:19.117Z",
    "enable": true,
    "filters": [
      {
        "key": "created_at",
        "operator": "eq",
        "value": [
          "string"
        ]
      }
    ],
    "gateway_id": "my-gateway",
    "modified_at": "2019-12-27T18:11:19.117Z",
    "name": "name"
  },
  "success": true
}
```

## Create a new Dataset

`client.aiGateway.datasets.create(stringgatewayId, DatasetCreateParamsparams, RequestOptionsoptions?): DatasetCreateResponse`

**post** `/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/datasets`

Creates a new AI Gateway.

### Parameters

- `gatewayId: string`

  gateway id

- `params: DatasetCreateParams`

  - `account_id: string`

    Path param

  - `enable: boolean`

    Body param

  - `filters: Array<Filter>`

    Body param

    - `key: "created_at" | "request_content_type" | "response_content_type" | 10 more`

      - `"created_at"`

      - `"request_content_type"`

      - `"response_content_type"`

      - `"success"`

      - `"cached"`

      - `"provider"`

      - `"model"`

      - `"cost"`

      - `"tokens"`

      - `"tokens_in"`

      - `"tokens_out"`

      - `"duration"`

      - `"feedback"`

    - `operator: "eq" | "contains" | "lt" | "gt"`

      - `"eq"`

      - `"contains"`

      - `"lt"`

      - `"gt"`

    - `value: Array<string | number | boolean>`

      - `string`

      - `number`

      - `boolean`

  - `name: string`

    Body param

### Returns

- `DatasetCreateResponse`

  - `id: string`

  - `created_at: string`

  - `enable: boolean`

  - `filters: Array<Filter>`

    - `key: "created_at" | "request_content_type" | "response_content_type" | 10 more`

      - `"created_at"`

      - `"request_content_type"`

      - `"response_content_type"`

      - `"success"`

      - `"cached"`

      - `"provider"`

      - `"model"`

      - `"cost"`

      - `"tokens"`

      - `"tokens_in"`

      - `"tokens_out"`

      - `"duration"`

      - `"feedback"`

    - `operator: "eq" | "contains" | "lt" | "gt"`

      - `"eq"`

      - `"contains"`

      - `"lt"`

      - `"gt"`

    - `value: Array<string | number | boolean>`

      - `string`

      - `number`

      - `boolean`

  - `gateway_id: string`

    gateway id

  - `modified_at: string`

  - `name: string`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const dataset = await client.aiGateway.datasets.create('my-gateway', {
  account_id: '3ebbcb006d4d46d7bb6a8c7f14676cb0',
  enable: true,
  filters: [
    {
      key: 'created_at',
      operator: 'eq',
      value: ['string'],
    },
  ],
  name: 'name',
});

console.log(dataset.id);
```

#### Response

```json
{
  "result": {
    "id": "id",
    "created_at": "2019-12-27T18:11:19.117Z",
    "enable": true,
    "filters": [
      {
        "key": "created_at",
        "operator": "eq",
        "value": [
          "string"
        ]
      }
    ],
    "gateway_id": "my-gateway",
    "modified_at": "2019-12-27T18:11:19.117Z",
    "name": "name"
  },
  "success": true
}
```

## Update a Dataset

`client.aiGateway.datasets.update(stringgatewayId, stringid, DatasetUpdateParamsparams, RequestOptionsoptions?): DatasetUpdateResponse`

**put** `/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/datasets/{id}`

Updates an existing AI Gateway dataset.

### Parameters

- `gatewayId: string`

  gateway id

- `id: string`

- `params: DatasetUpdateParams`

  - `account_id: string`

    Path param

  - `enable: boolean`

    Body param

  - `filters: Array<Filter>`

    Body param

    - `key: "created_at" | "request_content_type" | "response_content_type" | 10 more`

      - `"created_at"`

      - `"request_content_type"`

      - `"response_content_type"`

      - `"success"`

      - `"cached"`

      - `"provider"`

      - `"model"`

      - `"cost"`

      - `"tokens"`

      - `"tokens_in"`

      - `"tokens_out"`

      - `"duration"`

      - `"feedback"`

    - `operator: "eq" | "contains" | "lt" | "gt"`

      - `"eq"`

      - `"contains"`

      - `"lt"`

      - `"gt"`

    - `value: Array<string | number | boolean>`

      - `string`

      - `number`

      - `boolean`

  - `name: string`

    Body param

### Returns

- `DatasetUpdateResponse`

  - `id: string`

  - `created_at: string`

  - `enable: boolean`

  - `filters: Array<Filter>`

    - `key: "created_at" | "request_content_type" | "response_content_type" | 10 more`

      - `"created_at"`

      - `"request_content_type"`

      - `"response_content_type"`

      - `"success"`

      - `"cached"`

      - `"provider"`

      - `"model"`

      - `"cost"`

      - `"tokens"`

      - `"tokens_in"`

      - `"tokens_out"`

      - `"duration"`

      - `"feedback"`

    - `operator: "eq" | "contains" | "lt" | "gt"`

      - `"eq"`

      - `"contains"`

      - `"lt"`

      - `"gt"`

    - `value: Array<string | number | boolean>`

      - `string`

      - `number`

      - `boolean`

  - `gateway_id: string`

    gateway id

  - `modified_at: string`

  - `name: string`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const dataset = await client.aiGateway.datasets.update('my-gateway', 'id', {
  account_id: '3ebbcb006d4d46d7bb6a8c7f14676cb0',
  enable: true,
  filters: [
    {
      key: 'created_at',
      operator: 'eq',
      value: ['string'],
    },
  ],
  name: 'name',
});

console.log(dataset.id);
```

#### Response

```json
{
  "result": {
    "id": "id",
    "created_at": "2019-12-27T18:11:19.117Z",
    "enable": true,
    "filters": [
      {
        "key": "created_at",
        "operator": "eq",
        "value": [
          "string"
        ]
      }
    ],
    "gateway_id": "my-gateway",
    "modified_at": "2019-12-27T18:11:19.117Z",
    "name": "name"
  },
  "success": true
}
```

## Delete a Dataset

`client.aiGateway.datasets.delete(stringgatewayId, stringid, DatasetDeleteParamsparams, RequestOptionsoptions?): DatasetDeleteResponse`

**delete** `/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/datasets/{id}`

Deletes an AI Gateway dataset.

### Parameters

- `gatewayId: string`

  gateway id

- `id: string`

- `params: DatasetDeleteParams`

  - `account_id: string`

### Returns

- `DatasetDeleteResponse`

  - `id: string`

  - `created_at: string`

  - `enable: boolean`

  - `filters: Array<Filter>`

    - `key: "created_at" | "request_content_type" | "response_content_type" | 10 more`

      - `"created_at"`

      - `"request_content_type"`

      - `"response_content_type"`

      - `"success"`

      - `"cached"`

      - `"provider"`

      - `"model"`

      - `"cost"`

      - `"tokens"`

      - `"tokens_in"`

      - `"tokens_out"`

      - `"duration"`

      - `"feedback"`

    - `operator: "eq" | "contains" | "lt" | "gt"`

      - `"eq"`

      - `"contains"`

      - `"lt"`

      - `"gt"`

    - `value: Array<string | number | boolean>`

      - `string`

      - `number`

      - `boolean`

  - `gateway_id: string`

    gateway id

  - `modified_at: string`

  - `name: string`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const dataset = await client.aiGateway.datasets.delete('my-gateway', 'id', {
  account_id: '3ebbcb006d4d46d7bb6a8c7f14676cb0',
});

console.log(dataset.id);
```

#### Response

```json
{
  "result": {
    "id": "id",
    "created_at": "2019-12-27T18:11:19.117Z",
    "enable": true,
    "filters": [
      {
        "key": "created_at",
        "operator": "eq",
        "value": [
          "string"
        ]
      }
    ],
    "gateway_id": "my-gateway",
    "modified_at": "2019-12-27T18:11:19.117Z",
    "name": "name"
  },
  "success": true
}
```

## Domain Types

### Dataset List Response

- `DatasetListResponse`

  - `id: string`

  - `created_at: string`

  - `enable: boolean`

  - `filters: Array<Filter>`

    - `key: "created_at" | "request_content_type" | "response_content_type" | 10 more`

      - `"created_at"`

      - `"request_content_type"`

      - `"response_content_type"`

      - `"success"`

      - `"cached"`

      - `"provider"`

      - `"model"`

      - `"cost"`

      - `"tokens"`

      - `"tokens_in"`

      - `"tokens_out"`

      - `"duration"`

      - `"feedback"`

    - `operator: "eq" | "contains" | "lt" | "gt"`

      - `"eq"`

      - `"contains"`

      - `"lt"`

      - `"gt"`

    - `value: Array<string | number | boolean>`

      - `string`

      - `number`

      - `boolean`

  - `gateway_id: string`

    gateway id

  - `modified_at: string`

  - `name: string`

### Dataset Get Response

- `DatasetGetResponse`

  - `id: string`

  - `created_at: string`

  - `enable: boolean`

  - `filters: Array<Filter>`

    - `key: "created_at" | "request_content_type" | "response_content_type" | 10 more`

      - `"created_at"`

      - `"request_content_type"`

      - `"response_content_type"`

      - `"success"`

      - `"cached"`

      - `"provider"`

      - `"model"`

      - `"cost"`

      - `"tokens"`

      - `"tokens_in"`

      - `"tokens_out"`

      - `"duration"`

      - `"feedback"`

    - `operator: "eq" | "contains" | "lt" | "gt"`

      - `"eq"`

      - `"contains"`

      - `"lt"`

      - `"gt"`

    - `value: Array<string | number | boolean>`

      - `string`

      - `number`

      - `boolean`

  - `gateway_id: string`

    gateway id

  - `modified_at: string`

  - `name: string`

### Dataset Create Response

- `DatasetCreateResponse`

  - `id: string`

  - `created_at: string`

  - `enable: boolean`

  - `filters: Array<Filter>`

    - `key: "created_at" | "request_content_type" | "response_content_type" | 10 more`

      - `"created_at"`

      - `"request_content_type"`

      - `"response_content_type"`

      - `"success"`

      - `"cached"`

      - `"provider"`

      - `"model"`

      - `"cost"`

      - `"tokens"`

      - `"tokens_in"`

      - `"tokens_out"`

      - `"duration"`

      - `"feedback"`

    - `operator: "eq" | "contains" | "lt" | "gt"`

      - `"eq"`

      - `"contains"`

      - `"lt"`

      - `"gt"`

    - `value: Array<string | number | boolean>`

      - `string`

      - `number`

      - `boolean`

  - `gateway_id: string`

    gateway id

  - `modified_at: string`

  - `name: string`

### Dataset Update Response

- `DatasetUpdateResponse`

  - `id: string`

  - `created_at: string`

  - `enable: boolean`

  - `filters: Array<Filter>`

    - `key: "created_at" | "request_content_type" | "response_content_type" | 10 more`

      - `"created_at"`

      - `"request_content_type"`

      - `"response_content_type"`

      - `"success"`

      - `"cached"`

      - `"provider"`

      - `"model"`

      - `"cost"`

      - `"tokens"`

      - `"tokens_in"`

      - `"tokens_out"`

      - `"duration"`

      - `"feedback"`

    - `operator: "eq" | "contains" | "lt" | "gt"`

      - `"eq"`

      - `"contains"`

      - `"lt"`

      - `"gt"`

    - `value: Array<string | number | boolean>`

      - `string`

      - `number`

      - `boolean`

  - `gateway_id: string`

    gateway id

  - `modified_at: string`

  - `name: string`

### Dataset Delete Response

- `DatasetDeleteResponse`

  - `id: string`

  - `created_at: string`

  - `enable: boolean`

  - `filters: Array<Filter>`

    - `key: "created_at" | "request_content_type" | "response_content_type" | 10 more`

      - `"created_at"`

      - `"request_content_type"`

      - `"response_content_type"`

      - `"success"`

      - `"cached"`

      - `"provider"`

      - `"model"`

      - `"cost"`

      - `"tokens"`

      - `"tokens_in"`

      - `"tokens_out"`

      - `"duration"`

      - `"feedback"`

    - `operator: "eq" | "contains" | "lt" | "gt"`

      - `"eq"`

      - `"contains"`

      - `"lt"`

      - `"gt"`

    - `value: Array<string | number | boolean>`

      - `string`

      - `number`

      - `boolean`

  - `gateway_id: string`

    gateway id

  - `modified_at: string`

  - `name: string`