API Reference

AI Gateway

Datasets

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Update a Dataset

client.AIGateway.Datasets.Update(ctx, gatewayID, id, params) (*DatasetUpdateResponse, error)

PUT/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/datasets/{id}

Updates an existing AI Gateway dataset.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

Accepted Permissions (at least one required)

AI Gateway Write

ParametersExpand Collapse

gatewayID string

gateway id

maxLength64

minLength1

id string

params DatasetUpdateParams

AccountID param.Field[string]

Path param

Enable param.Field[bool]

Body param

Filters param.Field[[]DatasetUpdateParamsFilter]

Body param

Key DatasetUpdateParamsFiltersKey

One of the following:

const DatasetUpdateParamsFiltersKeyCreatedAt DatasetUpdateParamsFiltersKey = "created_at"

const DatasetUpdateParamsFiltersKeyRequestContentType DatasetUpdateParamsFiltersKey = "request_content_type"

const DatasetUpdateParamsFiltersKeyResponseContentType DatasetUpdateParamsFiltersKey = "response_content_type"

const DatasetUpdateParamsFiltersKeySuccess DatasetUpdateParamsFiltersKey = "success"

const DatasetUpdateParamsFiltersKeyCached DatasetUpdateParamsFiltersKey = "cached"

const DatasetUpdateParamsFiltersKeyProvider DatasetUpdateParamsFiltersKey = "provider"

const DatasetUpdateParamsFiltersKeyModel DatasetUpdateParamsFiltersKey = "model"

const DatasetUpdateParamsFiltersKeyCost DatasetUpdateParamsFiltersKey = "cost"

const DatasetUpdateParamsFiltersKeyTokens DatasetUpdateParamsFiltersKey = "tokens"

const DatasetUpdateParamsFiltersKeyTokensIn DatasetUpdateParamsFiltersKey = "tokens_in"

const DatasetUpdateParamsFiltersKeyTokensOut DatasetUpdateParamsFiltersKey = "tokens_out"

const DatasetUpdateParamsFiltersKeyDuration DatasetUpdateParamsFiltersKey = "duration"

const DatasetUpdateParamsFiltersKeyFeedback DatasetUpdateParamsFiltersKey = "feedback"

Operator DatasetUpdateParamsFiltersOperator

One of the following:

const DatasetUpdateParamsFiltersOperatorEq DatasetUpdateParamsFiltersOperator = "eq"

const DatasetUpdateParamsFiltersOperatorContains DatasetUpdateParamsFiltersOperator = "contains"

const DatasetUpdateParamsFiltersOperatorLt DatasetUpdateParamsFiltersOperator = "lt"

const DatasetUpdateParamsFiltersOperatorGt DatasetUpdateParamsFiltersOperator = "gt"

Value []DatasetUpdateParamsFiltersValueUnion

One of the following:

UnionString

UnionFloat

UnionBool

Name param.Field[string]

Body param

ReturnsExpand Collapse

type DatasetUpdateResponse struct{…}

ID string

CreatedAt Time

formatdate-time

Enable bool

Filters []DatasetUpdateResponseFilter

Key DatasetUpdateResponseFiltersKey

One of the following:

const DatasetUpdateResponseFiltersKeyCreatedAt DatasetUpdateResponseFiltersKey = "created_at"

const DatasetUpdateResponseFiltersKeyRequestContentType DatasetUpdateResponseFiltersKey = "request_content_type"

const DatasetUpdateResponseFiltersKeyResponseContentType DatasetUpdateResponseFiltersKey = "response_content_type"

const DatasetUpdateResponseFiltersKeySuccess DatasetUpdateResponseFiltersKey = "success"

const DatasetUpdateResponseFiltersKeyCached DatasetUpdateResponseFiltersKey = "cached"

const DatasetUpdateResponseFiltersKeyProvider DatasetUpdateResponseFiltersKey = "provider"

const DatasetUpdateResponseFiltersKeyModel DatasetUpdateResponseFiltersKey = "model"

const DatasetUpdateResponseFiltersKeyCost DatasetUpdateResponseFiltersKey = "cost"

const DatasetUpdateResponseFiltersKeyTokens DatasetUpdateResponseFiltersKey = "tokens"

const DatasetUpdateResponseFiltersKeyTokensIn DatasetUpdateResponseFiltersKey = "tokens_in"

const DatasetUpdateResponseFiltersKeyTokensOut DatasetUpdateResponseFiltersKey = "tokens_out"

const DatasetUpdateResponseFiltersKeyDuration DatasetUpdateResponseFiltersKey = "duration"

const DatasetUpdateResponseFiltersKeyFeedback DatasetUpdateResponseFiltersKey = "feedback"

Operator DatasetUpdateResponseFiltersOperator

One of the following:

const DatasetUpdateResponseFiltersOperatorEq DatasetUpdateResponseFiltersOperator = "eq"

const DatasetUpdateResponseFiltersOperatorContains DatasetUpdateResponseFiltersOperator = "contains"

const DatasetUpdateResponseFiltersOperatorLt DatasetUpdateResponseFiltersOperator = "lt"

const DatasetUpdateResponseFiltersOperatorGt DatasetUpdateResponseFiltersOperator = "gt"

Value []DatasetUpdateResponseFiltersValueUnion

One of the following:

UnionString

UnionFloat

UnionBool

GatewayID string

gateway id

maxLength64

minLength1

ModifiedAt Time

formatdate-time

Name string

Update a Dataset

Go

HTTP

TypeScript

Python

Go

Terraform

package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/ai_gateway"
  "github.com/cloudflare/cloudflare-go/option"
  "github.com/cloudflare/cloudflare-go/shared"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  dataset, err := client.AIGateway.Datasets.Update(
    context.TODO(),
    "my-gateway",
    "id",
    ai_gateway.DatasetUpdateParams{
      AccountID: cloudflare.F("3ebbcb006d4d46d7bb6a8c7f14676cb0"),
      Enable: cloudflare.F(true),
      Filters: cloudflare.F([]ai_gateway.DatasetUpdateParamsFilter{ai_gateway.DatasetUpdateParamsFilter{
        Key: cloudflare.F(ai_gateway.DatasetUpdateParamsFiltersKeyCreatedAt),
        Operator: cloudflare.F(ai_gateway.DatasetUpdateParamsFiltersOperatorEq),
        Value: cloudflare.F([]ai_gateway.DatasetUpdateParamsFiltersValueUnion{shared.UnionString("string")}),
      }}),
      Name: cloudflare.F("name"),
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", dataset.ID)
}

200 example

{
  "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
}

Returns Examples

200 example

{
  "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
}