Base URL
All API endpoints are relative to your Seemodo instance:Authentication
Most endpoints don’t require authentication for local development. For production deployments, configure authentication via environment variables. For Seemodo Cloud (Supabase) endpoints, include the Supabase API token in the header:API Categories
Code Generation
Generate React screens from natural language prompts using AI.
Sandbox Management
Create, manage, and interact with cloud development sandboxes.
AI Utilities
Enhance prompts, analyze intents, and brainstorm ideas.
Seemodo Cloud
Integrate Supabase backend services into your projects.
Request Format
All POST endpoints accept JSON payloads:Response Format
Responses are JSON objects with a consistent structure:Common Response Codes
| Code | Description |
|---|---|
200 | Success |
400 | Bad request - missing or invalid parameters |
401 | Unauthorized - missing or invalid authentication |
404 | Not found - resource doesn’t exist |
500 | Server error - check error details |
Rate Limiting
API calls are subject to rate limiting based on your subscription plan. When rate limited, you’ll receive a429 status code. Wait and retry after the specified time.
Available Endpoints
Code Generation
| Endpoint | Method | Description |
|---|---|---|
/generate-screen | POST | Generate a single screen from prompt |
/generate-flow | POST | Generate multiple connected screens |
/edit-screen | POST | Edit an existing screen |
/enhance-prompt | POST | Improve a prompt for better results |
Sandbox Management
| Endpoint | Method | Description |
|---|---|---|
/create-ai-sandbox | POST | Create a new sandbox |
/create-ai-sandbox-v2 | POST | Create sandbox with Modal backend |
/sandbox-status | GET | Check sandbox health status |
/get-sandbox-files | GET | List all files in sandbox |
/kill-sandbox | POST | Terminate a sandbox |
/restart-vite | POST | Restart the Vite dev server |
Website Cloning
| Endpoint | Method | Description |
|---|---|---|
/scrape-website | POST | Scrape website content and structure |
/scrape-url-enhanced | POST | Enhanced scraping with screenshots |
/scrape-screenshot | POST | Capture website screenshot |
Seemodo Cloud
| Endpoint | Method | Description |
|---|---|---|
/seemodo-cloud | POST | Manage Supabase integration |
/supabase-proxy/* | * | Proxy requests to Supabase |