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.
Endpoints
Section titled “Endpoints”| 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 |
Source
Section titled “Source”Read from crates/fw-edge/data/openapi_paths.json.