Engine REST API — Complete Port 5000 Reference

📘 General go v1

Complete reference for all 40+ REST API endpoints on the Go Engine (Port 5000). Covers file I/O, terminal execution, app management, workflows, knowledge bank, git, and diagnostics.

API Categories

File Operations

| Method | Endpoint | Purpose | |--------|----------|---------| | POST | /api/ai-write | Write files to app/node | | GET | /api/ai-read/:type/:id | Read all files | | POST | /api/ai-search | Grep-like search | | POST | /api/ai-rename | Rename file | | GET | /api/ai-context/:type/:id | Full project context | | POST | /api/ai-smart-patch | Line-based smart patching |

Terminal

| POST | /api/ai-exec | Execute command (10s timeout) | | POST | /api/terminal/start | Start async terminal session | | GET | /api/terminal/status/:id | Get terminal output | | POST | /api/terminal/input/:id | Send input to terminal | | POST | /api/terminal/kill/:id | Kill terminal session |

Apps & Nodes

| GET | /api/local-apps | List installed apps | | GET | /api/local-nodes | List installed nodes | | POST | /api/upload | Upload .flow/.nflow package | | POST | /api/compile | Compile app to .exe |

Workflows

| POST | /api/workflow/save | Create/save workflow | | PATCH | /api/workflow/:id | Update workflow | | POST | /api/workflow/execute/:id | Execute workflow | | GET | /api/workflow/list | List workflows |

Knowledge Bank

| POST | /api/knowledge | Save knowledge | | GET | /api/knowledge | Recall knowledge | | DELETE | /api/knowledge | Delete knowledge |

Git

| POST | /api/git | All git operations (action in body) |

Diagnostics

| GET | /api/engine-logs | Engine status | | POST/GET | /api/crash-history | Crash reports | | POST/GET | /api/progress-log | Progress tracking |