Search docs...
DocsAPIHono Cloud API

Hono Cloud API

Cloud synchronization, database schemas, and REST endpoints for collaborative lead workspaces.

2 min readEdit on GitHub

The Hono Cloud API serves as the centralized synchronization backend and collaborative workspace storage for LeadForge OS.

API Endpoint Reference

EndpointMethodDescription
/healthGETHeartbeat health status and MongoDB connection verification.
/auth/loginPOSTAuthenticates credentials and issues session cookie.
/auth/registerPOSTRegisters new user profiles.
/auth/sessionGETResolves and verifies the active session.
/business/syncPOSTSyncs local SQLite mutations in batch mode using Last-Write-Wins (LWW).
/business/companiesGETFetches all synced company entities.
/business/companiesPOSTCreates or updates company entities.
/business/contactsGETFetches synced contact lists.
/automation/sequencesGETFetches email outreach sequences.
/automation/sequencesPOSTDeploys or modifies outreach sequences.

Sync Request Example

The following POST payload syncs a mutation from the client's local SQLite database:

bash
curl -X POST http://localhost:3000/business/sync \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer session_token_here" \
  -d '{
    "workspaceId": "ws_abc123",
    "mutations": [
      {
        "table": "companies",
        "action": "INSERT",
        "id": "comp_99",
        "data": {
          "name": "Acme Corp",
          "domain": "acme.com",
          "updatedAt": "2026-08-03T12:00:00Z"
        }
      }
    ]
  }'

To run the API server locally and access the interactive Scalar UI, execute:

bash
pnpm dev --filter=api

Navigate to http://localhost:3000/reference for complete OpenAPI parameter schemas.