Skip to main content
The Seemodo API provides programmatic access to all AI-powered code generation, sandbox management, and cloud integration features.

Base URL

All API endpoints are relative to your Seemodo instance:
https://your-domain.com/api/
For local development:
http://app.seemodo.ai/api/

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:
curl -X POST https://your-domain.com/api/seemodo-cloud \
  -H "Content-Type: application/json" \
  -H "X-Supabase-Token: your-supabase-token" \
  -d '{"action": "status", "projectRef": "your-project-ref"}'

API Categories

Request Format

All POST endpoints accept JSON payloads:
curl -X POST https://your-domain.com/api/generate-screen \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A modern dashboard with analytics charts",
    "width": 1280,
    "height": 800,
    "screenType": "Desktop"
  }'

Response Format

Responses are JSON objects with a consistent structure:
{
  "success": true,
  "data": { ... },
  "message": "Operation completed successfully"
}
Error responses include details:
{
  "success": false,
  "error": "Error message",
  "details": "Additional error context"
}

Common Response Codes

CodeDescription
200Success
400Bad request - missing or invalid parameters
401Unauthorized - missing or invalid authentication
404Not found - resource doesn’t exist
500Server error - check error details

Rate Limiting

API calls are subject to rate limiting based on your subscription plan. When rate limited, you’ll receive a 429 status code. Wait and retry after the specified time.

Available Endpoints

Code Generation

EndpointMethodDescription
/generate-screenPOSTGenerate a single screen from prompt
/generate-flowPOSTGenerate multiple connected screens
/edit-screenPOSTEdit an existing screen
/enhance-promptPOSTImprove a prompt for better results

Sandbox Management

EndpointMethodDescription
/create-ai-sandboxPOSTCreate a new sandbox
/create-ai-sandbox-v2POSTCreate sandbox with Modal backend
/sandbox-statusGETCheck sandbox health status
/get-sandbox-filesGETList all files in sandbox
/kill-sandboxPOSTTerminate a sandbox
/restart-vitePOSTRestart the Vite dev server

Website Cloning

EndpointMethodDescription
/scrape-websitePOSTScrape website content and structure
/scrape-url-enhancedPOSTEnhanced scraping with screenshots
/scrape-screenshotPOSTCapture website screenshot

Seemodo Cloud

EndpointMethodDescription
/seemodo-cloudPOSTManage Supabase integration
/supabase-proxy/**Proxy requests to Supabase