> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Cloudflare API

> Check and manage Cloudflare DNS records, proxying, zone and SSL settings, Zero Trust policies and tunnel health

The common uses are a ticket about email deliverability (check SPF, DKIM and DMARC, and add the records a mail service such as Mailchimp needs), a website that is down or shows an SSL error (is the record proxied, what is the SSL mode), and a user who cannot reach an app behind Zero Trust (which Access policy or Gateway rule applies, is the tunnel healthy).

> [!NOTE]
>
> Automatically enabled when you configure Cloudflare permissions in your agent workflow.

## What It Does

* Read, add, change and remove DNS records, and see which records are proxied
* Read and change zone settings (SSL mode, Always Use HTTPS, minimum TLS, development mode), page rules and cache rules, and purge the cache
* Read and order edge certificates, custom hostnames and origin certificates
* Read and change WAF and custom rules, rate limits and IP lists
* Read Zero Trust Access applications, policies and groups, and the Access login log
* Read Gateway rules, WARP devices and device profiles
* Check each Cloudflare Tunnel's status, its connectors and what it serves
* Read load balancers and their health, email routing and Email Security, Workers and Pages, analytics and the audit log

## Permission Groups

| Group | Access levels | Covers |
| - | - | - |
| Zones, Settings & Cache | Disabled, Read Only, Read/Write | Zones, zone settings, page rules, cache rules and purges, custom pages |
| DNS | Disabled, Read Only, Read/Write | DNS records and proxying, DNSSEC, secondary DNS, DNS settings |
| SSL/TLS & Certificates | Disabled, Read Only, Read/Write | Edge, custom, origin and client certificates, custom hostnames |
| Security & WAF | Disabled, Read Only, Read/Write | WAF and custom rules, rulesets, IP lists, rate limits, bots, Turnstile, Page Shield, API Shield |
| Zero Trust Access | Disabled, Read Only, Read/Write | Access applications, policies, groups, identity providers, service tokens, users |
| Zero Trust Gateway, Devices & DLP | Disabled, Read Only, Read/Write | Gateway rules, lists and locations, WARP devices and profiles, DEX, DLP |
| Tunnels & Networks | Disabled, Read Only, Read/Write | Cloudflare Tunnels and their connectors, private routes, Magic WAN, traceroutes |
| Load Balancing & Traffic | Disabled, Read Only, Read/Write | Load balancers, pools, monitors, health checks, waiting rooms, Spectrum |
| Email Routing & Email Security | Disabled, Read Only, Read/Write | Email routing rules and addresses, Email Security |
| Workers, Pages & Developer Platform | Disabled, Read Only, Read/Write | Workers, Pages, KV, R2, D1, Queues, Images, Stream, Workers AI |
| Analytics, Logs & Notifications | Disabled, Read Only, Read/Write | Analytics, the audit log, Logpush jobs, notifications |
| Threat Intelligence & Radar | Disabled, Read Only, Read/Write | Domain and IP intelligence, brand protection, Radar |
| Domain Registration | Disabled, Read Only, Read/Write | Domains registered at Cloudflare, availability checks, registration and auto-renew |
| Accounts, Members & Billing | Disabled, Read Only, Read/Write | Accounts, members and roles, API tokens, subscriptions and billing |

Neo always asks a technician before it deletes anything, before it runs an action that purges, stops, disables, restores or rolls back (such as a cache purge, a Stream input disable or a D1 restore; a DNS batch and an R2 lifecycle rule included), before it edits or pauses a zone or changes its settings (such as the SSL mode) or anything in SSL/TLS & Certificates, puts an R2 bucket on a domain, before it changes anything in Security & WAF (WAF, firewall and rate-limit rules, Page Shield, Bot Management, API Shield) in Accounts, Members & Billing, in Zero Trust Gateway, Devices & DLP (Gateway rules, WARP devices, DLP), changes anything in Email Routing & Email Security, DDoS protection, Universal SSL or Total TLS, deletes a certificate pack, or in Zero Trust Access (applications, policies, groups, identity providers, users, service tokens), deletes a zone, adds, changes or removes an account member, user group or resource group, changes or deletes an API token, changes single sign-on, revokes, restores, deletes or disconnects WARP devices, changes secondary DNS or DNSSEC, changes a Stream video or live input, changes Email Routing's settings or removes its DNS records, changes the Gateway configuration or its certificates, changes an OAuth client, changes anything in Realtime Kit (meetings, presets, participants), shares the account's resources with other accounts, grants or revokes other accounts' threat-intelligence access, adds or removes another account on an address map or prefix delegation, accepts an invitation to another account, moves an account to another organization, or sets where Cloudflare sends data (a webhook, a notification destination, a Logpush job, an email forwarding rule or address) or removes one, turns email routing off, cancels a subscription, mutes alerts or removes an alert policy, destination or Logpush job, sends email, a WARP device notification or releases or moves quarantined email, submits or appeals an abuse report, submits brand-protection URLs, an email sample or a miscategorization, writes a Cloudforce One request or message, makes Cloudflare fetch a URL (Browser Rendering, a Stream copy, an import, a custom page), turns off signed URLs on a hosted image, does anything that charges the account (a domain registration or transfer, a plan or subscription, a top-up, an invoice payment), or starts a meeting recording, livestream or stream output, whatever the group's approval setting. It also asks before it rewrites a whole record that holds a secret it hides from the agent (a ruleset, the Zaraz configuration, a Worker, an AI Gateway gateway, a tunnel), because a write without that secret would erase it. It never deletes an account, never reads or changes the billing profile or payment methods, never reads a tunnel's token, an API token's value, a browser session's recording (or runs a script in one), raw request logs (Logpull, Log Explorer), Workers Observability events, build and job logs, abuse reports, Cloudforce One requests and takedown letters, the list of held emails, a held email's detail or raw message, or a PhishGuard report or what an application stores (R2 object listings, Artifacts commits, Realtime recordings and participants, AI Search, Vectorize and Durable Object inventories, Stream videos, live inputs, Realtime livestreams, hosted images, SQL API and Analytics Engine queries, KV values, queue messages, D1 rows, vectors, AI Search content, meeting transcripts), never reads or makes a WARP override code, never sends a password, private key, client secret or token in a request, and hides every secret in Cloudflare's answers. On a ticket, the agent works only on the accounts and zones mapped to the ticket's company.

Turning something off through an ordinary edit in another area, such as a load balancer's `enabled` flag, follows the area's approval setting, like any other change there.

## Setup

See [Connecting Cloudflare to Neo](https://docs.neoagent.io/integrations/cloudflare/connecting-to-neo.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.