API Reference

Programmatic access to Momo - authentication, chat, app management, and dashboard data.

Base URL

https://app.momo-agent.xyz/api

All endpoints except /auth/* require a JWT bearer token:

Authorization: Bearer <token>

Obtain a token via POST /api/auth/login or the /connect Telegram command for a magic link.

Method	Endpoint	Description
POST	`/api/auth/register`	Create account. Body: `{"email","password"}`
POST	`/api/auth/login`	Login, returns JWT token
POST	`/api/auth/telegram`	Telegram Mini App auth via initData
POST	`/api/auth/connect`	Generate magic link from Telegram session

Method	Endpoint	Description
POST	`/api/chat`	Send a message. Body: `{"message":"string","agentType":"assistant\|builder\|crypto"}`. Returns `{"reply":"string","apps":[...]}`

Method	Endpoint	Description
GET	`/api/apps`	List all apps for authenticated user
GET	`/api/apps/:userId/:file`	Serve a built app HTML file (public, no auth)

Method	Endpoint	Description
GET	`/api/dashboard`	Get user dashboard data - todos, expenses, notes, events, workouts
POST	`/api/dashboard`	Save dashboard data (full or partial object)

// Success
{ "success": true, "data": { ... } }

// Error  
{ "success": false, "error": "Error message" }