API Reference

Create a new account

{ "email": "[email protected]", "password": "..." , "name": "..." }

{ "token": "eyJ...", "user": { "id": "...", "email": "...", "name": "..." } }

Sign in and get a JWT token

{ "email": "[email protected]", "password": "..." }

{ "token": "eyJ...", "user": { "id": "...", "email": "...", "name": "..." } }

Get current user profile

{ "id": "...", "email": "...", "name": "...", "role": "user" }

Send a message to the AI assistant. Response is streamed via SSE. The assistant can call MCP tools to answer factory-related questions.

{ "message": "What's the current OEE?", "conversationId": "optional-id" }

SSE stream: data: { "type": "text|tool_call|tool_result", ... }

List all conversations for the current user

[{ "id": "...", "title": "...", "updatedAt": "..." }]

Get a specific conversation with message history

Delete a conversation

List all available agents (built-in + community)

[{ "id": "...", "name": "...", "description": "...", "icon": "...", "type": "builtin|community" }]

Execute an agent. Response is streamed via SSE.

SSE stream: data: { "type": "log|result|error", ... }

List past runs for an agent

Deploy a new code agent from a GitHub repository

{ "repoFullName": "user/repo", "branch": "main" }

List all deployed code agents for the current user

Manually trigger a re-sync from the GitHub repository

Remove a deployed code agent

List all saved flows for the current user

[{ "id": "...", "name": "...", "description": "...", "nodeCount": 5 }]

Save a new flow from the Node-RED editor

{ "name": "...", "description": "...", "nodes": [...], "wires": [...] }

Execute a saved flow. Response is streamed via SSE.

SSE stream: data: { "nodeId": "...", "type": "start|result|error", ... }

Delete a saved flow

Call any MCP tool through the gateway proxy. The gateway routes to the correct MCP server based on the tool name prefix.

{ "tool": "factory_get_latest_oee", "args": {} }

{ "result": { ... } }

List all available MCP tools across all servers

[{ "name": "...", "description": "...", "parameters": {...} }]

Start GitHub OAuth flow for connecting a GitHub account

List repositories for the connected GitHub account

Webhook endpoint for GitHub push events (auto-sync)