Skip to content

fw edge Worker API

Unified Cloudflare Edge OS Worker: Durable Object SQLite VFS, 3-tier execution (DO POSIX, Dynamic Worker Loader CodeMode, Sandbox microVM), Gatekeeper policy engine, autonomous learning log, and OpenAI / MCP / ACP / A2A protocol gateway.

Method Path Summary
GET /.well-known/agent.json A2A AgentCard
POST /a2a A2A JSON-RPC 2.0 (tasks/send, tasks/get)
POST /acp ACP JSON-RPC 2.0 (initialize, session/new, session/prompt)
GET /api/learn/events List autonomous learning log events
POST /api/learn/events Append learning event (DO SQLite + K2 + Basin Pipelines)
GET /api/learn/status Autonomous learning log metrics and sink readiness
GET /drive/_id/{fileId} Drive CDN by file id, limited to the shared root folder
GET /drive/_whoami Identity from the Cloudflare Access token (user email or service-token client id)
GET /drive/{path} Drive CDN behind Cloudflare Access: folder listing (JSON or HTML) or file bytes from the R2 cache, Range and ETag aware
GET /health Edge OS health and active bindings
POST /mcp Streamable HTTP MCP JSON-RPC 2.0 (initialize, tools/list, tools/call)
GET /openapi.json OpenAPI 3.1 schema
GET /os/catalog Verified Nov 2026 Cloudflare Edge OS ecosystem catalog
GET /os/gatekeeper List Gatekeeper capability rules
POST /os/gatekeeper Evaluate or upsert Gatekeeper capability policies
GET /os/tiers 3-tier execution architecture and live binding readiness
POST /os/vfs/exec 3-tier execution router (Tier-0 DO POSIX, Tier-1 LOADER CodeMode, Tier-2 Sandbox microVM)
GET /os/vfs/ls List tenant SQLite VFS entries
POST /os/vfs/ls List tenant SQLite VFS entries
GET /os/vfs/read Read file from tenant SQLite VFS / R2 spillover
POST /os/vfs/read Read file from tenant SQLite VFS / R2 spillover
GET /os/vfs/stat Stat tenant SQLite VFS path
POST /os/vfs/stat Stat tenant SQLite VFS path
POST /os/vfs/write Write file to tenant SQLite VFS with Gatekeeper check
POST /v1/chat/completions OpenAI-compatible chat (stream or not) via Cloudflare Workers AI; 503 without the AI binding
POST /v1/embeddings OpenAI-compatible embeddings with optional Vectorize upsert
GET /v1/models OpenAI-compatible model list

Read from crates/fw-edge/data/openapi_paths.json.