API Reference

RESTful API for generating full‑stack applications programmatically.

POST /v1/generate

Start a new generation task.

Request body (JSON):

{
  "prompt": "Build a task manager with drag-and-drop",
  "options": {
    "frontend_framework": "react",
    "backend_framework": "fastapi"
  }
}

Response:

{
  "task_id": "task_abc123",
  "status": "pending",
  "websocket_url": "wss://api.genesiscraft.ai/ws/tasks/task_abc123"
}

GET /v1/tasks/{task_id}

Get task status and generated artifacts.

{
  "task_id": "task_abc123",
  "status": "completed",
  "artifacts": [
    {"file_path": "src/App.jsx", "content": "...", "language": "javascript"}
  ]
}

GET /v1/health

Health check endpoint.

{"status": "ok"}