Quickstart

Generate your first full‑stack application in 3 steps:

1. Sign up for a free account at genesiscraft.ai/signup
2. Get your API key from the dashboard
3. Run a curl command:

curl -X POST https://api.genesiscraft.ai/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Build a task manager with drag-and-drop"}'

The response will contain a task_id. Poll the status endpoint or connect via WebSocket.

API Reference

POST /v1/generate

Start a new generation task.

{
  "prompt": "string (required)",
  "options": {
    "frontend_framework": "react|vue|angular",
    "backend_framework": "fastapi|express|django"
  }
}

{
  "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.

Authentication

All API requests require a Bearer token. Include your API key in the Authorization header:

Authorization: Bearer your_api_key_here

Rate Limits

Free tier: 50 requests per minute. Pro and Team tiers have higher limits. See Pricing for details.

Rate limit headers are returned with every response:

• X-RateLimit-Limit – requests per minute
• X-RateLimit-Remaining – remaining requests
• X-RateLimit-Reset – time until reset (UTC epoch seconds)

Webhooks

Configure a webhook URL in your dashboard to receive events when generation tasks complete or fail.

Example payload:

{
  "event": "task.completed",
  "task_id": "task_abc123",
  "status": "completed",
  "artifacts": [...]
}