Learn more about our native MCP
Integrations

Cloudflare Workers

Integrate Directus with Cloudflare Workers Builds to trigger deployments, track build progress, and manage Workers from within your Directus instance.

When your frontend runs on Cloudflare Workers and pulls content from Directus, publishing a content change doesn't automatically trigger a new build. This integration adds deployment controls to Directus so your team can trigger builds, track progress, and review logs without switching to the Cloudflare dashboard.

Quick Start
  1. Enable the Deployment module in your Directus project settings (under Modules).
  2. Link Cloudflare: open the Deployment module and choose Configure Cloudflare Workers (or add the provider from Settings).
  3. Enter credentials and Account ID (see below), save, then select which Workers to manage.
  4. Deploy from a Worker's project view, or use an optional Deploy Hook action if you configured hook URLs.
Public instance required Real-time deployment status updates rely on webhooks sent from your provider to your Directus instance. Your instance must be publicly accessible for these webhooks to reach it. If you're developing locally, use a tunneling tool like ngrok or untun to expose your local API.

Getting Started

Link Your Cloudflare Account

  1. In Directus, go to Settings.
  2. Under Modules, enable Deployment.
  3. Open the Deployment module from the primary navigation.
  4. Select Configure Cloudflare Workers (the label may appear as Cloudflare Workers in the provider list).
  5. Provide your credentials:
    • Personal Access Token: a user-scoped Cloudflare API token (not an account token) with at least:
      • Workers Builds Configuration: Edit
      • Workers Scripts: Read
    • Account ID: your Cloudflare account ID (the 32-character hex string shown in the dashboard URL and account overview).

    Use Open Cloudflare Settings in the form to create or manage tokens in the Cloudflare dashboard.
  6. Click Save to validate and continue to project selection.

Directus stores the token encrypted. Changing the token or Account ID after setup can make previously selected Workers unavailable until you update credentials or re-select them.

Workers Builds Prerequisites

For a Worker to appear as deployable in Directus, Cloudflare must have:

  • Workers Builds enabled for that Worker.
  • A connected Git repository and a build trigger configured.

If Directus shows that a Worker is not deployable, open Worker Settings → Builds in the Cloudflare dashboard and complete setup (the in-app copy points you there).

Configure Workers

  1. From the Cloudflare Workers configuration screen, choose which Workers Directus should manage.
  2. Click Save to store the selection.
  3. Return to integration settings anytime to add or remove Workers.
Removing Workers
Removing a Worker from this integration permanently deletes all deployment history stored in Directus for that Worker. This cannot be undone.

Optional: Deploy Hooks

In Cloudflare, create Deploy Hook URLs under Worker Settings → Builds → Deploy Hooks. In Directus, you can add each hook with a name and URL. Those hooks appear in the Deploy menu as extra actions (for example Deploy via …) alongside the default production deploy.

View Your Workers

Once set up, connected Workers appear under the Cloudflare Workers provider. From here you can:

  • See selected Workers and their deployment activity.
  • Open a Worker to run deployments and browse deployment runs, logs, and links.
Permissions
The Deployment module uses Directus native permissions. See Deployment Security for details on configuring roles and access policies.

Documentation

Working with Deployments →

Trigger deployments, track build status, and view logs from within Directus.

Get once-a-month release notes & real‑world code tips...no fluff. 🐰

Deployments

Full guide for triggering builds, tracking deployment progress, and viewing logs for your Netlify sites from Directus.

Deployments

Trigger Workers Builds, track deployment status, and view logs for Cloudflare Workers from Directus.