{"openapi":"3.0.0","info":{"description":"Cloudflare AI Gateway control plane — gateways, custom providers and their costs, datasets, evaluations, request logs, provider configs and dynamic routes with versions and deployments.","version":[]},"servers":[{"description":"Cloudflare AI Gateway control plane — gateways, custom providers and their costs, datasets, evaluations, request logs, provider configs and dynamic routes with versions and deployments.","url":"https://api.apirails.com/cloudflare-ai-gateway"}],"paths":{"/client/v4/accounts/{account_id}/ai-gateway/custom-providers":{"get":{"tags":["Custom Providers"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"beta","in":"query","description":"beta","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"enable","in":"query","description":"enable","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"page","in":"query","description":"page","required":false,"schema":{"type":"number","example":""}},{"name":"per_page","in":"query","description":"per page","required":false,"schema":{"type":"number","example":""}},{"name":"search","in":"query","description":"Search by id, name, slug","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/custom-providers"},"summary":"List Account Providers","description":"Lists all AI Gateway evaluator types configured for the account.","security":[{"bearerAuth":[]}]},"post":{"tags":["Custom Providers"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/custom-providers"},"summary":"Create a new Account Provider","description":"Creates a new AI Gateway.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"base_url":{"type":"string","description":"base url","required":true},"beta":{"type":"boolean","description":"beta","enum":[true,false]},"curl_example":{"type":"string","description":"curl example"},"description":{"type":"string","description":"description"},"enable":{"type":"boolean","description":"enable","enum":[true,false]},"headers":{"type":"string","description":"headers"},"js_example":{"type":"string","description":"js example"},"link":{"type":"string","description":"link"},"name":{"type":"string","description":"name","required":true},"position":{"type":"number","description":"position"},"slug":{"type":"string","description":"slug","required":true}}},"example":{"base_url":"","beta":"","curl_example":"","description":"","enable":"","headers":"","js_example":"","link":"","name":"","position":"","slug":""}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/custom-providers/costs":{"get":{"tags":["Custom Provider Costs"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"account_provider_id","in":"query","description":"account provider id","required":false,"schema":{"type":"string","example":""}},{"name":"cost_type","in":"query","description":"cost type","required":false,"schema":{"type":"string","example":""}},{"name":"enable","in":"query","description":"enable","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"model_rule","in":"query","description":"model rule","required":false,"schema":{"type":"string","example":"","items":{"type":"string","enum":["equals","starts-with","contains"]}}},{"name":"page","in":"query","description":"page","required":false,"schema":{"type":"number","example":""}},{"name":"per_page","in":"query","description":"per page","required":false,"schema":{"type":"number","example":""}},{"name":"search","in":"query","description":"Search by model, changed_by","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/custom-providers/costs"},"summary":"List Account Provider Costs","description":"Lists all AI Gateway evaluator types configured for the account.","security":[{"bearerAuth":[]}]},"post":{"tags":["Custom Provider Costs"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/custom-providers/costs"},"summary":"Create a new Account Provider Cost","description":"Creates a new AI Gateway.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"account_provider_id":{"type":"string","description":"account provider id","required":true},"cost_in":{"type":"number","description":"cost in"},"cost_out":{"type":"number","description":"cost out"},"cost_type":{"type":"string","description":"cost type"},"enable":{"type":"boolean","description":"enable","enum":[true,false]},"model":{"type":"string","description":"model","required":true},"model_rule":{"type":"string","description":"model rule","enum":["equals","starts-with","contains"]},"token_pricing":{"type":"object","description":"token pricing","properties":{}}}},"example":{"account_provider_id":"","cost_in":"","cost_out":"","cost_type":"","enable":"","model":"","model_rule":"","token_pricing":{}}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/custom-providers/costs/{id}":{"get":{"tags":["Custom Provider Costs"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/custom-providers/costs/{id}"},"summary":"Fetch a Account Provider Cost","description":"Retrieves details for a specific AI Gateway dataset.","security":[{"bearerAuth":[]}]},"patch":{"tags":["Custom Provider Costs"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/custom-providers/costs/{id}"},"summary":"Update a Account Provider Cost","description":"Updates an existing AI Gateway dataset.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cost_in":{"type":"number","description":"cost in"},"cost_out":{"type":"number","description":"cost out"},"cost_type":{"type":"string","description":"cost type"},"enable":{"type":"boolean","description":"enable","enum":[true,false]},"model":{"type":"string","description":"model"},"model_rule":{"type":"string","description":"model rule","enum":["equals","starts-with","contains"]},"token_pricing":{"type":"object","description":"token pricing","properties":{}}}},"example":{"cost_in":"","cost_out":"","cost_type":"","enable":"","model":"","model_rule":"","token_pricing":{}}}}}},"delete":{"tags":["Custom Provider Costs"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/custom-providers/costs/{id}"},"summary":"Delete a Account Provider Cost","description":"Deletes an AI Gateway dataset.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/custom-providers/{id}":{"get":{"tags":["Custom Providers"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/custom-providers/{id}"},"summary":"Fetch a Account Provider","description":"Retrieves details for a specific AI Gateway dataset.","security":[{"bearerAuth":[]}]},"patch":{"tags":["Custom Providers"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/custom-providers/{id}"},"summary":"Update a Account Provider","description":"Updates an existing AI Gateway dataset.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"base_url":{"type":"string","description":"base url"},"beta":{"type":"boolean","description":"beta","enum":[true,false]},"curl_example":{"type":"string","description":"curl example"},"description":{"type":"string","description":"description"},"enable":{"type":"boolean","description":"enable","enum":[true,false]},"headers":{"type":"string","description":"headers"},"js_example":{"type":"string","description":"js example"},"link":{"type":"string","description":"link"},"logo":{"type":"string","description":"logo"},"name":{"type":"string","description":"name"},"position":{"type":"number","description":"position"},"slug":{"type":"string","description":"slug"}}},"example":{"base_url":"","beta":"","curl_example":"","description":"","enable":"","headers":"","js_example":"","link":"","logo":"","name":"","position":"","slug":""}}}}},"delete":{"tags":["Custom Providers"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/custom-providers/{id}"},"summary":"Delete a Account Provider","description":"Deletes an AI Gateway dataset.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/evaluation-types":{"get":{"tags":["Evaluations"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"order_by","in":"query","description":"order by","required":false,"schema":{"type":"string","example":""}},{"name":"order_by_direction","in":"query","description":"order by direction","required":false,"schema":{"type":"string","example":"","items":{"type":"string","enum":["asc","desc"]}}},{"name":"page","in":"query","description":"page","required":false,"schema":{"type":"number","example":""}},{"name":"per_page","in":"query","description":"per page","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/evaluation-types"},"summary":"List Evaluators","description":"Lists all available evaluator types for scoring AI gateway responses.","security":[{"bearerAuth":[]}]}},"/client/v4/accounts/{account_id}/ai-gateway/gateways":{"get":{"tags":["Gateways"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"page","in":"query","description":"page","required":false,"schema":{"type":"number","example":""}},{"name":"per_page","in":"query","description":"per page","required":false,"schema":{"type":"number","example":""}},{"name":"search","in":"query","description":"Search by id","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways"},"summary":"List Gateways","description":"Lists all AI Gateway evaluator types configured for the account.","security":[{"bearerAuth":[]}]},"post":{"tags":["Gateways"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways"},"summary":"Create a new Gateway","description":"Creates a new AI Gateway.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"authentication":{"type":"boolean","description":"authentication","enum":[true,false]},"byok_only":{"type":"boolean","description":"Requires customer-provided provider credentials and prevents fallback to Unified Billing.","enum":[true,false]},"cache_invalidate_on_update":{"type":"boolean","description":"cache invalidate on update","required":true,"enum":[true,false]},"cache_ttl":{"type":"number","description":"cache ttl","required":true},"collect_logs":{"type":"boolean","description":"collect logs","required":true,"enum":[true,false]},"id":{"type":"string","description":"gateway id","required":true},"log_management":{"type":"number","description":"log management"},"log_management_strategy":{"type":"string","description":"log management strategy","enum":["STOP_INSERTING","DELETE_OLDEST"]},"logpush":{"type":"boolean","description":"logpush","enum":[true,false]},"logpush_public_key":{"type":"string","description":"logpush public key"},"rate_limiting_interval":{"type":"number","description":"rate limiting interval","required":true},"rate_limiting_limit":{"type":"number","description":"rate limiting limit","required":true},"rate_limiting_technique":{"type":"string","description":"rate limiting technique","enum":["fixed","sliding"]},"retry_backoff":{"type":"string","description":"Backoff strategy for retry delays","enum":["constant","linear","exponential"]},"retry_delay":{"type":"number","description":"Delay between retry attempts in milliseconds (0-60000)"},"retry_max_attempts":{"type":"number","description":"Maximum number of retry attempts for failed requests (1-5)"},"store_id":{"type":"string","description":"store id"},"workers_ai_billing_mode":{"type":"string","description":"Controls how Workers AI inference calls routed through this gateway are billed. 'postpaid' bills the account directly through Workers AI; 'unified' deducts credits via AI Gateway using neuron-based pricing and delegates billing to AI Gateway.","enum":["postpaid","unified"]},"zdr":{"type":"boolean","description":"zdr","enum":[true,false]}}},"example":{"authentication":"","byok_only":"","cache_invalidate_on_update":"","cache_ttl":"","collect_logs":"","id":"","log_management":"","log_management_strategy":"","logpush":"","logpush_public_key":"","rate_limiting_interval":"","rate_limiting_limit":"","rate_limiting_technique":"","retry_backoff":"","retry_delay":"","retry_max_attempts":"","store_id":"","workers_ai_billing_mode":"","zdr":""}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/custom-domains":{"get":{"tags":["Custom Domains"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"page","in":"query","description":"page","required":false,"schema":{"type":"number","example":""}},{"name":"per_page","in":"query","description":"per page","required":false,"schema":{"type":"number","example":""}},{"name":"search","in":"query","description":"Search by hostname","required":false,"schema":{"type":"string","example":""}},{"name":"status","in":"query","description":"status","required":false,"schema":{"type":"string","example":"","items":{"type":"string","enum":["initializing","pending_dcv","active","blocked","error"]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/custom-domains"},"summary":"List Custom Domains","description":"Lists all AI Gateway evaluator types configured for the account.","security":[{"bearerAuth":[]}]},"post":{"tags":["Custom Domains"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/custom-domains"},"summary":"Create a custom domain for a gateway","description":"Provisions a Cloudflare-for-SaaS custom hostname and returns the CNAME target to point DNS at.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"domain":{"type":"string","description":"the customer-owned custom hostname","required":true},"minTLS":{"type":"string","description":"minTLS","enum":["1.0","1.1","1.2","1.3"]},"zone_id":{"type":"string","description":"Cloudflare Zone ID owning the custom hostname","required":true}}},"example":{"domain":"","minTLS":"","zone_id":""}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/custom-domains/{hostname}":{"get":{"tags":["Custom Domains"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"hostname","in":"path","description":"the customer-owned custom hostname","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/custom-domains/{hostname}"},"summary":"Fetch a Custom Domain","description":"Retrieves details for a specific AI Gateway dataset.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Custom Domains"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"hostname","in":"path","description":"the customer-owned custom hostname","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/custom-domains/{hostname}"},"summary":"Delete a Custom Domain","description":"Deletes an AI Gateway dataset.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/datasets":{"get":{"tags":["Datasets"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"enable","in":"query","description":"enable","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"name","in":"query","description":"name","required":false,"schema":{"type":"string","example":""}},{"name":"page","in":"query","description":"page","required":false,"schema":{"type":"number","example":""}},{"name":"per_page","in":"query","description":"per page","required":false,"schema":{"type":"number","example":""}},{"name":"search","in":"query","description":"Search by id, name, filters","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/datasets"},"summary":"List Datasets","description":"Lists all AI Gateway evaluator types configured for the account.","security":[{"bearerAuth":[]}]},"post":{"tags":["Datasets"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/datasets"},"summary":"Create a new Dataset","description":"Creates a new AI Gateway.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"enable":{"type":"boolean","description":"enable","required":true,"enum":[true,false]},"filters":{"type":"array","description":"filters","required":true,"items":{"type":"object","properties":{}}},"name":{"type":"string","description":"name","required":true}}},"example":{"enable":"","filters":[],"name":""}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/datasets/{id}":{"get":{"tags":["Datasets"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/datasets/{id}"},"summary":"Fetch a Dataset","description":"Retrieves details for a specific AI Gateway dataset.","security":[{"bearerAuth":[]}]},"put":{"tags":["Datasets"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/datasets/{id}"},"summary":"Update a Dataset","description":"Updates an existing AI Gateway dataset.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"enable":{"type":"boolean","description":"enable","required":true,"enum":[true,false]},"filters":{"type":"array","description":"filters","required":true,"items":{"type":"object","properties":{}}},"name":{"type":"string","description":"name","required":true}}},"example":{"enable":"","filters":[],"name":""}}}}},"delete":{"tags":["Datasets"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/datasets/{id}"},"summary":"Delete a Dataset","description":"Deletes an AI Gateway dataset.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/evaluations":{"get":{"tags":["Evaluations"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"name","in":"query","description":"name","required":false,"schema":{"type":"string","example":""}},{"name":"page","in":"query","description":"page","required":false,"schema":{"type":"number","example":""}},{"name":"per_page","in":"query","description":"per page","required":false,"schema":{"type":"number","example":""}},{"name":"processed","in":"query","description":"processed","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"search","in":"query","description":"Search by id, name","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/evaluations"},"summary":"List Evaluations","description":"Lists all AI Gateway evaluator types configured for the account.","security":[{"bearerAuth":[]}]},"post":{"tags":["Evaluations"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/evaluations"},"summary":"Create a new Evaluation","description":"Creates a new AI Gateway.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"dataset_ids":{"type":"array","description":"dataset ids","required":true,"items":{"type":"string"}},"evaluation_type_ids":{"type":"array","description":"evaluation type ids","required":true,"items":{"type":"string"}},"name":{"type":"string","description":"name","required":true}}},"example":{"dataset_ids":[],"evaluation_type_ids":[],"name":""}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/evaluations/{id}":{"get":{"tags":["Evaluations"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/evaluations/{id}"},"summary":"Fetch a Evaluation","description":"Retrieves details for a specific AI Gateway dataset.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Evaluations"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/evaluations/{id}"},"summary":"Delete a Evaluation","description":"Deletes an AI Gateway dataset.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs":{"get":{"tags":["Logs"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"cached","in":"query","description":"cached","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"direction","in":"query","description":"direction","required":false,"schema":{"type":"string","example":"","items":{"type":"string","enum":["asc","desc"]}}},{"name":"end_date","in":"query","description":"end date","required":false,"schema":{"type":"string","example":""}},{"name":"feedback","in":"query","description":"feedback","required":false,"schema":{"type":"string","example":""}},{"name":"filters","in":"query","description":"filters","required":false,"schema":{"type":"array","example":""}},{"name":"max_cost","in":"query","description":"max cost","required":false,"schema":{"type":"number","example":""}},{"name":"max_duration","in":"query","description":"max duration","required":false,"schema":{"type":"number","example":""}},{"name":"max_tokens_in","in":"query","description":"max tokens in","required":false,"schema":{"type":"number","example":""}},{"name":"max_tokens_out","in":"query","description":"max tokens out","required":false,"schema":{"type":"number","example":""}},{"name":"max_total_tokens","in":"query","description":"max total tokens","required":false,"schema":{"type":"number","example":""}},{"name":"meta_info","in":"query","description":"meta info","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"min_cost","in":"query","description":"min cost","required":false,"schema":{"type":"number","example":""}},{"name":"min_duration","in":"query","description":"min duration","required":false,"schema":{"type":"number","example":""}},{"name":"min_tokens_in","in":"query","description":"min tokens in","required":false,"schema":{"type":"number","example":""}},{"name":"min_tokens_out","in":"query","description":"min tokens out","required":false,"schema":{"type":"number","example":""}},{"name":"min_total_tokens","in":"query","description":"min total tokens","required":false,"schema":{"type":"number","example":""}},{"name":"model","in":"query","description":"model","required":false,"schema":{"type":"string","example":""}},{"name":"model_type","in":"query","description":"model type","required":false,"schema":{"type":"string","example":""}},{"name":"order_by","in":"query","description":"order by","required":false,"schema":{"type":"string","example":"","items":{"type":"string","enum":["created_at","provider","model","model_type","success","cached"]}}},{"name":"order_by_direction","in":"query","description":"order by direction","required":false,"schema":{"type":"string","example":"","items":{"type":"string","enum":["asc","desc"]}}},{"name":"page","in":"query","description":"page","required":false,"schema":{"type":"number","example":""}},{"name":"per_page","in":"query","description":"per page","required":false,"schema":{"type":"number","example":""}},{"name":"provider","in":"query","description":"provider","required":false,"schema":{"type":"string","example":""}},{"name":"request_content_type","in":"query","description":"request content type","required":false,"schema":{"type":"string","example":""}},{"name":"response_content_type","in":"query","description":"response content type","required":false,"schema":{"type":"string","example":""}},{"name":"search","in":"query","description":"search","required":false,"schema":{"type":"string","example":""}},{"name":"start_date","in":"query","description":"start date","required":false,"schema":{"type":"string","example":""}},{"name":"success","in":"query","description":"success","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs"},"summary":"List Gateway Logs","description":"Lists request/response log entries for the AI gateway with filtering and pagination.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Logs"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"filters","in":"query","description":"filters","required":false,"schema":{"type":"array","example":""}},{"name":"limit","in":"query","description":"limit","required":false,"schema":{"type":"number","example":""}},{"name":"order_by","in":"query","description":"order by","required":false,"schema":{"type":"string","example":"","items":{"type":"string","enum":["created_at","provider","model","model_type","success","cached","cost","tokens_in","tokens_out","duration","feedback"]}}},{"name":"order_by_direction","in":"query","description":"order by direction","required":false,"schema":{"type":"string","example":"","items":{"type":"string","enum":["asc","desc"]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs"},"summary":"Delete Gateway Logs","description":"Deletes gateway log entries matching the specified criteria.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs/{id}":{"get":{"tags":["Logs"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs/{id}"},"summary":"Get Gateway Log Detail","description":"Retrieves detailed information for a specific AI Gateway log entry.","security":[{"bearerAuth":[]}]},"patch":{"tags":["Logs"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs/{id}"},"summary":"Patch Gateway Log","description":"Updates metadata for an AI Gateway log entry.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"feedback":{"type":"number","description":"feedback"},"metadata":{"type":"object","description":"metadata","properties":{}},"score":{"type":"number","description":"score"}}},"example":{"feedback":"","metadata":{},"score":""}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs/{id}/request":{"get":{"tags":["Logs"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs/{id}/request"},"summary":"Get Gateway Log Request","description":"Retrieves the original request payload for an AI Gateway log entry.","security":[{"bearerAuth":[]}]}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs/{id}/response":{"get":{"tags":["Logs"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs/{id}/response"},"summary":"Get Gateway Log Response","description":"Retrieves the response payload for an AI Gateway log entry.","security":[{"bearerAuth":[]}]}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/provider_configs":{"get":{"tags":["Provider Configs"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"page","in":"query","description":"page","required":false,"schema":{"type":"number","example":""}},{"name":"per_page","in":"query","description":"per page","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/provider_configs"},"summary":"List Provider Configs","description":"Lists all AI Gateway evaluator types configured for the account.","security":[{"bearerAuth":[]}]},"post":{"tags":["Provider Configs"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/provider_configs"},"summary":"Create a new Provider Configs","description":"Creates a new AI Gateway.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"alias":{"type":"string","description":"alias","required":true},"default_config":{"type":"boolean","description":"default config","required":true,"enum":[true,false]},"provider_slug":{"type":"string","description":"provider slug","required":true},"rate_limit":{"type":"number","description":"rate limit"},"rate_limit_period":{"type":"number","description":"rate limit period"},"secret":{"type":"string","description":"secret"},"secret_id":{"type":"string","description":"secret id"}}},"example":{"alias":"","default_config":"","provider_slug":"","rate_limit":"","rate_limit_period":"","secret":"","secret_id":""}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/provider_configs/{id}":{"put":{"tags":["Provider Configs"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/provider_configs/{id}"},"summary":"Update a Provider Configs","description":"Updates an existing AI Gateway dataset.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"secret":{"type":"string","description":"secret","required":true}}},"example":{"secret":""}}}}},"delete":{"tags":["Provider Configs"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/provider_configs/{id}"},"summary":"Delete a Provider Configs","description":"Deletes an AI Gateway dataset.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/routes":{"get":{"tags":["Dynamic Routes"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"page","in":"query","description":"Page number","required":false,"schema":{"type":"number","example":""}},{"name":"per_page","in":"query","description":"Number of routes per page","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/routes"},"summary":"List all AI Gateway Dynamic Routes","description":"List all AI Gateway Dynamic Routes.","security":[{"bearerAuth":[]}]},"post":{"tags":["Dynamic Routes"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/routes"},"summary":"Create a new AI Gateway Dynamic Route","description":"Create a new AI Gateway Dynamic Route.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"elements":{"type":"array","description":"elements","required":true,"items":{"type":"object","properties":{}}},"name":{"type":"string","description":"name","required":true}}},"example":{"elements":[],"name":""}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/routes/{id}":{"get":{"tags":["Dynamic Routes"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/routes/{id}"},"summary":"Get an AI Gateway Dynamic Route","description":"Get an AI Gateway Dynamic Route.","security":[{"bearerAuth":[]}]},"patch":{"tags":["Dynamic Routes"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/routes/{id}"},"summary":"Update an AI Gateway Dynamic Route","description":"Update an AI Gateway Dynamic Route.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"name","required":true}}},"example":{"name":""}}}}},"delete":{"tags":["Dynamic Routes"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/routes/{id}"},"summary":"Delete an AI Gateway Dynamic Route","description":"Delete an AI Gateway Dynamic Route.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/routes/{id}/deployments":{"get":{"tags":["Dynamic Routes"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/routes/{id}/deployments"},"summary":"List all AI Gateway Dynamic Route Deployments","description":"List all AI Gateway Dynamic Route Deployments.","security":[{"bearerAuth":[]}]},"post":{"tags":["Dynamic Routes"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/routes/{id}/deployments"},"summary":"Create a new AI Gateway Dynamic Route Deployment","description":"Create a new AI Gateway Dynamic Route Deployment.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"version_id":{"type":"string","description":"version id","required":true}}},"example":{"version_id":""}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/routes/{id}/versions":{"get":{"tags":["Dynamic Routes"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/routes/{id}/versions"},"summary":"List all AI Gateway Dynamic Route Versions","description":"List all AI Gateway Dynamic Route Versions.","security":[{"bearerAuth":[]}]},"post":{"tags":["Dynamic Routes"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/routes/{id}/versions"},"summary":"Create a new AI Gateway Dynamic Route Version","description":"Create a new AI Gateway Dynamic Route Version.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"elements":{"type":"array","description":"elements","required":true,"items":{"type":"object","properties":{}}}}},"example":{"elements":[]}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/routes/{id}/versions/{version_id}":{"get":{"tags":["Dynamic Routes"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"string","example":""}},{"name":"version_id","in":"path","description":"version id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/routes/{id}/versions/{version_id}"},"summary":"Get an AI Gateway Dynamic Route Version","description":"Get an AI Gateway Dynamic Route Version.","security":[{"bearerAuth":[]}]}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/url/{provider}":{"get":{"tags":["Gateways"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"gateway_id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}},{"name":"provider","in":"path","description":"provider","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/url/{provider}"},"summary":"Get Gateway URL","description":"Retrieves the endpoint URL for an AI Gateway.","security":[{"bearerAuth":[]}]}},"/client/v4/accounts/{account_id}/ai-gateway/gateways/{id}":{"get":{"tags":["Gateways"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{id}"},"summary":"Fetch a Gateway","description":"Retrieves details for a specific AI Gateway dataset.","security":[{"bearerAuth":[]}]},"put":{"tags":["Gateways"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{id}"},"summary":"Update a Gateway","description":"Updates an existing AI Gateway dataset.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"authentication":{"type":"boolean","description":"authentication","enum":[true,false]},"byok_only":{"type":"boolean","description":"Requires customer-provided provider credentials and prevents fallback to Unified Billing.","enum":[true,false]},"cache_invalidate_on_update":{"type":"boolean","description":"cache invalidate on update","required":true,"enum":[true,false]},"cache_ttl":{"type":"number","description":"cache ttl","required":true},"collect_logs":{"type":"boolean","description":"collect logs","required":true,"enum":[true,false]},"dlp":{"type":"string","description":"dlp"},"guardrails":{"type":"object","description":"guardrails","properties":{}},"log_classification":{"type":"boolean","description":"log classification","enum":[true,false]},"log_management":{"type":"number","description":"log management"},"log_management_strategy":{"type":"string","description":"log management strategy","enum":["STOP_INSERTING","DELETE_OLDEST"]},"logpush":{"type":"boolean","description":"logpush","enum":[true,false]},"logpush_public_key":{"type":"string","description":"logpush public key"},"otel":{"type":"array","description":"otel","items":{"type":"object","properties":{}}},"rate_limiting_interval":{"type":"number","description":"rate limiting interval","required":true},"rate_limiting_limit":{"type":"number","description":"rate limiting limit","required":true},"rate_limiting_technique":{"type":"string","description":"rate limiting technique","enum":["fixed","sliding"]},"retry_backoff":{"type":"string","description":"Backoff strategy for retry delays","enum":["constant","linear","exponential"]},"retry_delay":{"type":"number","description":"Delay between retry attempts in milliseconds (0-60000)"},"retry_max_attempts":{"type":"number","description":"Maximum number of retry attempts for failed requests (1-5)"},"spend_limits":{"type":"object","description":"spend limits","properties":{}},"store_id":{"type":"string","description":"store id"},"stripe":{"type":"object","description":"stripe","properties":{}},"workers_ai_billing_mode":{"type":"string","description":"Controls how Workers AI inference calls routed through this gateway are billed. 'postpaid' bills the account directly through Workers AI; 'unified' deducts credits via AI Gateway using neuron-based pricing and delegates billing to AI Gateway.","enum":["postpaid","unified"]},"zdr":{"type":"boolean","description":"zdr","enum":[true,false]}}},"example":{"authentication":"","byok_only":"","cache_invalidate_on_update":"","cache_ttl":"","collect_logs":"","dlp":"","guardrails":{},"log_classification":"","log_management":"","log_management_strategy":"","logpush":"","logpush_public_key":"","otel":[],"rate_limiting_interval":"","rate_limiting_limit":"","rate_limiting_technique":"","retry_backoff":"","retry_delay":"","retry_max_attempts":"","spend_limits":{},"store_id":"","stripe":{},"workers_ai_billing_mode":"","zdr":""}}}}},"delete":{"tags":["Gateways"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"gateway id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/gateways/{id}"},"summary":"Delete a Gateway","description":"Deletes an AI Gateway dataset.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/client/v4/accounts/{account_id}/ai-gateway/logging-state":{"get":{"tags":["Settings"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/logging-state"},"summary":"Get AI Gateway logging state","description":"Returns the canonical logging platform and migration availability for an account.","security":[{"bearerAuth":[]}]},"patch":{"tags":["Settings"],"parameters":[{"name":"account_id","in":"path","description":"account id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.cloudflare.com/api/resources/ai_gateway/","api_endpoint":"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai-gateway/logging-state"},"summary":"Migrate AI Gateway logging to Workers Observability","description":"Irreversibly migrates an eligible account to Workers Observability logging.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}