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

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:
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