Cloudflare API | AI Gateway › Logs › List Gateway Logs

API Reference

Account & User Management

Resource Sharing

AI

Create a new Gateway

Delete a Gateway

Fetch a Gateway

Update a Gateway

Evaluation Types

Delete Gateway Logs

Patch Gateway Log

Get Gateway Log Detail

List Gateway Logs

Get Gateway Log Request

Get Gateway Log Response

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

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

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

path Parameters

account_id: string

gateway_id: string

(maxLength: 64, minLength: 1)

gateway id

query Parameters

cached: boolean

Optional

Deprecated

direction:

Optional

Deprecated

"asc"

"desc"

end_date: string

Optional

(format: date-time)

Deprecated

feedback:

Optional

Deprecated

0

1

filters: Array<{

Optional

key: "id" | "created_at" | "request_content_type" | 18 more...

operator: "eq" | "neq" | "contains" | 2 more...

value: Array<string | number | boolean>

}>

max_cost: number

Optional

Deprecated

max_duration: number

Optional

Deprecated

max_tokens_in: number

Optional

Deprecated

max_tokens_out: number

Optional

Deprecated

max_total_tokens: number

Optional

Deprecated

meta_info: boolean

Optional

min_cost: number

Optional

Deprecated

min_duration: number

Optional

Deprecated

min_tokens_in: number

Optional

Deprecated

min_tokens_out: number

Optional

Deprecated

min_total_tokens: number

Optional

Deprecated

model: string

Optional

Deprecated

model_type: string

Optional

Deprecated

order_by:

Optional

(default: "created_at")

"created_at"

"provider"

"model"

"model_type"

"success"

"cached"

order_by_direction:

Optional

(default: "desc")

"asc"

"desc"

page: number

Optional

(minimum: 1, default: 1)

per_page: number

Optional

(maximum: 50, minimum: 1, default: 20)

provider: string

Optional

Deprecated

request_content_type: string

Optional

Deprecated

response_content_type: string

Optional

Deprecated

search: string

Optional

start_date: string

Optional

(format: date-time)

Deprecated

success: boolean

Optional

Deprecated

Response fields

result: Array<{ id, cached, created_at, 16 more... }>

result_info: { count, max_cost, max_duration, 11 more... }

success: boolean

Request example

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

200Example

{
  "result": [
    {
      "id": "id",
      "cached": true,
      "duration": 0,
      "model": "model",
      "path": "path",
      "provider": "provider",
      "success": true,
      "tokens_in": 0,
      "tokens_out": 0,
      "cost": 0,
      "custom_cost": true,
      "metadata": "metadata",
      "model_type": "model_type",
      "request_content_type": "request_content_type",
      "request_type": "request_type",
      "response_content_type": "response_content_type",
      "status_code": 0,
      "step": 0
    }
  ],
  "result_info": {
    "count": 0,
    "max_cost": 0,
    "max_duration": 0,
    "max_tokens_in": 0,
    "max_tokens_out": 0,
    "max_total_tokens": 0,
    "min_cost": 0,
    "min_duration": 0,
    "min_tokens_in": 0,
    "min_tokens_out": 0,
    "min_total_tokens": 0,
    "page": 0,
    "per_page": 0,
    "total_count": 0
  },
  "success": true
}

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