Cloudflare Argo Smart Routing Skill Reference

Overview

Cloudflare Argo Smart Routing is a performance optimization service that detects real-time network issues and routes web traffic across the most efficient network path. It continuously monitors network conditions and intelligently routes traffic through the fastest, most reliable routes in Cloudflare's network.

Note on Smart Shield: Argo Smart Routing is being integrated into Cloudflare's Smart Shield product for enhanced DDoS protection and performance. Existing Argo customers maintain full functionality with gradual migration to Smart Shield features.

Quick Start

Enable via cURL

curl -X PATCH "https://api.cloudflare.com/client/v4/zones/{zone_id}/argo/smart_routing" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"value": "on"}'

Enable via TypeScript SDK

import Cloudflare from 'cloudflare';

const client = new Cloudflare({ apiToken: process.env.CLOUDFLARE_API_TOKEN });

const result = await client.argo.smartRouting.edit({
  zone_id: 'your-zone-id',
  value: 'on',
});

console.log(`Argo enabled: ${result.value}`);

Core Concepts

What It Does

Intelligent routing: Detects congestion, outages, packet loss in real-time
Global optimization: Routes across 300+ Cloudflare data centers
Automatic failover: Switches paths when issues detected (typically <1s)
Works with existing setup: No origin changes required

Billing Model

Usage-based: Charged per GB of traffic (excluding DDoS/WAF mitigated traffic)
Requires billing configuration before enabling
Available on Enterprise+ plans (check zone eligibility)

When to Use

High-traffic production sites with global user base
Latency-sensitive applications (APIs, real-time services)
Sites behind Cloudflare proxy (orange-clouded DNS records)
Combined with Tiered Cache for maximum performance gains

When NOT to Use

Development/staging environments (cost control)
Low-traffic sites (<1TB/month) where cost may exceed benefit
Sites with primarily single-region traffic

Should I Enable Argo?

Your Situation	Recommendation
Global production app, >1TB/month traffic	✅ Enable - likely ROI positive
Enterprise plan, latency-critical APIs	✅ Enable - performance matters
Regional site, <100GB/month traffic	⚠️ Evaluate - cost may not justify
Development/staging environment	❌ Disable - use in production only
Not yet configured billing	❌ Configure billing first

Reading Order by Task

Your Goal	Start With	Then Read
Enable Argo for first time	Quick Start above → configuration.md	gotchas.md
Use TypeScript/Python SDK	api.md	patterns.md
Terraform/IaC setup	configuration.md	-
Enable for Spectrum TCP app	patterns.md → Spectrum section	api.md
Troubleshoot enablement issue	gotchas.md	api.md
Manage billing/usage	patterns.md → Billing section	gotchas.md

In This Reference

api.md - API endpoints, SDK methods, error handling, Python/TypeScript examples
configuration.md - Terraform setup, environment config, billing configuration
patterns.md - Tiered Cache integration, Spectrum TCP apps, billing management, validation patterns
gotchas.md - Common errors, permission issues, limits, best practices

README.md