Cloudflare API | AI Gateway › Evaluations › List Evaluations

API Reference

Account & User Management

Resource Sharing

AI

Create a new Gateway

Delete a Gateway

Fetch a Gateway

Update a Gateway

Evaluation Types

Create a new Evaluation

Delete a Evaluation

Fetch a Evaluation

List Evaluations

Certificate Management

Certificate Authorities

Client Certificates

Custom Certificates

Custom Hostnames

Keyless Certificates

MTLS Certificates

Origin CA Certificates

Origin Post Quantum Encryption

Origin TLS Client Auth

Cloudflare One

DNS

Account Custom Nameservers

Domain/Zone Management

IP Addresses

Media

Networking

Magic Cloud Networking

Magic Network Monitoring

Network Interconnects

Observability

Security Center

Radar

Routing & Performance

Rules

Cloud Connector

Managed Transforms

URL Normalization

Security

Content Scanning

Leaked Credential Checks

Storage & Databases

Threat Intelligence

Brand Protection

Workers & Pages

Browser Rendering

Durable Objects

Workers For Platforms

Shared

AI Gateway

ai_gateway

Methods

Create A New Gateway -> Envelope<{ id, account_id, account_tag, 14 more... }>

post/accounts/{account_id}/ai-gateway/gateways

Create a new Gateway

Delete A Gateway -> Envelope<{ id, account_id, account_tag, 14 more... }>

delete/accounts/{account_id}/ai-gateway/gateways/{id}

Delete a Gateway

Fetch A Gateway -> Envelope<{ id, account_id, account_tag, 14 more... }>

get/accounts/{account_id}/ai-gateway/gateways/{id}

Fetch a Gateway

List Gateways -> V4PagePaginationArray<{ id, account_id, account_tag, 14 more... }>

get/accounts/{account_id}/ai-gateway/gateways

List Gateways

Update A Gateway -> Envelope<{ id, account_id, account_tag, 14 more... }>

put/accounts/{account_id}/ai-gateway/gateways/{id}

Update a Gateway

Datasets

ai_gateway.datasets

Methods

Create A New Dataset -> Envelope<{ id, account_id, account_tag, 6 more... }>

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

Create a new Dataset

Delete A Dataset -> Envelope<{ id, account_id, account_tag, 6 more... }>

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

Delete a Dataset

Fetch A Dataset -> Envelope<{ id, account_id, account_tag, 6 more... }>

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

Fetch a Dataset

List Datasets -> V4PagePaginationArray<{ id, account_id, account_tag, 6 more... }>

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

List Datasets

Update A Dataset -> Envelope<{ id, account_id, account_tag, 6 more... }>

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

Update a Dataset

Evaluation Types

ai_gateway.evaluation_types

Methods

List Evaluators -> V4PagePaginationArray<{ id, created_at, description, 5 more... }>

get/accounts/{account_id}/ai-gateway/evaluation-types

List Evaluators

Evaluations

ai_gateway.evaluations

Methods

Create A New Evaluation -> Envelope<{ id, account_id, account_tag, 8 more... }>

post/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/evaluations

Create a new Evaluation

Delete A Evaluation -> Envelope<{ id, account_id, account_tag, 8 more... }>

delete/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/evaluations/{id}

Delete a Evaluation

Fetch A Evaluation -> Envelope<{ id, account_id, account_tag, 8 more... }>

get/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/evaluations/{id}

Fetch a Evaluation

List Evaluations -> V4PagePaginationArray<{ id, account_id, account_tag, 8 more... }>

get/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/evaluations

List Evaluations

Security

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

Example: Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

Accepted Permissions (at least one required)

AI Gateway Write AI Gateway Read

Parameters

account_id: string

gateway_id: string

(maxLength: 64, minLength: 1)

gateway id

name: string

Optional

page: number

Optional

(minimum: 1)

per_page: number

Optional

(maximum: 100, minimum: 1)

processed: boolean

Optional

search: string

Optional

Search by id, name

Response fields

result: Array<{ id, account_id, account_tag, 8 more... }>

success: boolean

Request example

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/ai-gateway/gateways/$GATEWAY_ID/evaluations \
    -H "X-Auth-Email: $CLOUDFLARE_EMAIL" \
    -H "X-Auth-Key: $CLOUDFLARE_API_KEY"

200Example

{
  "result": [
    {
      "id": "id",
      "account_id": "account_id",
      "account_tag": "account_tag",
      "datasets": [
        {
          "id": "id",
          "account_id": "account_id",
          "account_tag": "account_tag",
          "enable": true,
          "filters": [
            {
              "key": "created_at",
              "operator": "eq",
              "value": [
                "string"
              ]
            }
          ],
          "gateway_id": "my-gateway",
          "name": "name"
        }
      ],
      "gateway_id": "my-gateway",
      "name": "name",
      "processed": true,
      "results": [
        {
          "id": "id",
          "evaluation_id": "evaluation_id",
          "evaluation_type_id": "evaluation_type_id",
          "result": "result",
          "status": 0,
          "status_description": "status_description",
          "total_logs": 0
        }
      ],
      "total_logs": 0
    }
  ],
  "success": true
}

Logs

ai_gateway.logs

Methods

Delete Gateway Logs -> { success }

delete/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs

Delete Gateway Logs

Patch Gateway Log -> Envelope<unknown>

patch/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs/{id}

Patch Gateway Log

Get Gateway Log Detail -> Envelope<{ id, cached, created_at, 22 more... }>

get/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs/{id}

Get Gateway Log Detail

List Gateway Logs -> V4PagePaginationArray<{ id, cached, created_at, 16 more... }>

get/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs

List Gateway Logs

Get Gateway Log Request -> unknown

get/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs/{id}/request

Get Gateway Log Request

Get Gateway Log Response -> unknown

get/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs/{id}/response

Get Gateway Log Response

URLs

ai_gateway.urls

Methods

Get Gateway URL -> Envelope<string>

get/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/url/{provider}

Get Gateway URL