Skip to content
Start here

Create a new Dataset

client.AIGateway.Datasets.New(ctx, gatewayID, params) (*DatasetNewResponse, error)
POST/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/datasets

Creates a new AI Gateway.

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
params DatasetNewParams
AccountID param.Field[string]

Path param

Enable param.Field[bool]

Body param

Filters param.Field[[]DatasetNewParamsFilter]

Body param

Key DatasetNewParamsFiltersKey
One of the following:
const DatasetNewParamsFiltersKeyCreatedAt DatasetNewParamsFiltersKey = "created_at"
const DatasetNewParamsFiltersKeyRequestContentType DatasetNewParamsFiltersKey = "request_content_type"
const DatasetNewParamsFiltersKeyResponseContentType DatasetNewParamsFiltersKey = "response_content_type"
const DatasetNewParamsFiltersKeySuccess DatasetNewParamsFiltersKey = "success"
const DatasetNewParamsFiltersKeyCached DatasetNewParamsFiltersKey = "cached"
const DatasetNewParamsFiltersKeyProvider DatasetNewParamsFiltersKey = "provider"
const DatasetNewParamsFiltersKeyModel DatasetNewParamsFiltersKey = "model"
const DatasetNewParamsFiltersKeyCost DatasetNewParamsFiltersKey = "cost"
const DatasetNewParamsFiltersKeyTokens DatasetNewParamsFiltersKey = "tokens"
const DatasetNewParamsFiltersKeyTokensIn DatasetNewParamsFiltersKey = "tokens_in"
const DatasetNewParamsFiltersKeyTokensOut DatasetNewParamsFiltersKey = "tokens_out"
const DatasetNewParamsFiltersKeyDuration DatasetNewParamsFiltersKey = "duration"
const DatasetNewParamsFiltersKeyFeedback DatasetNewParamsFiltersKey = "feedback"
Operator DatasetNewParamsFiltersOperator
One of the following:
const DatasetNewParamsFiltersOperatorEq DatasetNewParamsFiltersOperator = "eq"
const DatasetNewParamsFiltersOperatorContains DatasetNewParamsFiltersOperator = "contains"
const DatasetNewParamsFiltersOperatorLt DatasetNewParamsFiltersOperator = "lt"
const DatasetNewParamsFiltersOperatorGt DatasetNewParamsFiltersOperator = "gt"
Value []DatasetNewParamsFiltersValueUnion
One of the following:
UnionString
UnionFloat
UnionBool
Name param.Field[string]

Body param

ReturnsExpand Collapse
type DatasetNewResponse struct{…}
ID string
CreatedAt Time
formatdate-time
Enable bool
Filters []DatasetNewResponseFilter
Key DatasetNewResponseFiltersKey
One of the following:
const DatasetNewResponseFiltersKeyCreatedAt DatasetNewResponseFiltersKey = "created_at"
const DatasetNewResponseFiltersKeyRequestContentType DatasetNewResponseFiltersKey = "request_content_type"
const DatasetNewResponseFiltersKeyResponseContentType DatasetNewResponseFiltersKey = "response_content_type"
const DatasetNewResponseFiltersKeySuccess DatasetNewResponseFiltersKey = "success"
const DatasetNewResponseFiltersKeyCached DatasetNewResponseFiltersKey = "cached"
const DatasetNewResponseFiltersKeyProvider DatasetNewResponseFiltersKey = "provider"
const DatasetNewResponseFiltersKeyModel DatasetNewResponseFiltersKey = "model"
const DatasetNewResponseFiltersKeyCost DatasetNewResponseFiltersKey = "cost"
const DatasetNewResponseFiltersKeyTokens DatasetNewResponseFiltersKey = "tokens"
const DatasetNewResponseFiltersKeyTokensIn DatasetNewResponseFiltersKey = "tokens_in"
const DatasetNewResponseFiltersKeyTokensOut DatasetNewResponseFiltersKey = "tokens_out"
const DatasetNewResponseFiltersKeyDuration DatasetNewResponseFiltersKey = "duration"
const DatasetNewResponseFiltersKeyFeedback DatasetNewResponseFiltersKey = "feedback"
Operator DatasetNewResponseFiltersOperator
One of the following:
const DatasetNewResponseFiltersOperatorEq DatasetNewResponseFiltersOperator = "eq"
const DatasetNewResponseFiltersOperatorContains DatasetNewResponseFiltersOperator = "contains"
const DatasetNewResponseFiltersOperatorLt DatasetNewResponseFiltersOperator = "lt"
const DatasetNewResponseFiltersOperatorGt DatasetNewResponseFiltersOperator = "gt"
Value []DatasetNewResponseFiltersValueUnion
One of the following:
UnionString
UnionFloat
UnionBool
GatewayID string

gateway id

maxLength64
minLength1
ModifiedAt Time
formatdate-time
Name string

Create a new Dataset

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.New(
    context.TODO(),
    "my-gateway",
    ai_gateway.DatasetNewParams{
      AccountID: cloudflare.F("3ebbcb006d4d46d7bb6a8c7f14676cb0"),
      Enable: cloudflare.F(true),
      Filters: cloudflare.F([]ai_gateway.DatasetNewParamsFilter{ai_gateway.DatasetNewParamsFilter{
        Key: cloudflare.F(ai_gateway.DatasetNewParamsFiltersKeyCreatedAt),
        Operator: cloudflare.F(ai_gateway.DatasetNewParamsFiltersOperatorEq),
        Value: cloudflare.F([]ai_gateway.DatasetNewParamsFiltersValueUnion{shared.UnionString("string")}),
      }}),
      Name: cloudflare.F("name"),
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", dataset.ID)
}
{
  "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
{
  "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
}