> ## Documentation Index
> Fetch the complete documentation index at: https://docs.avallon.ca/llms.txt
> Use this file to discover all available pages before exploring further.
# Generate Website
> Create a new website from a description
## Endpoint
```http theme={null}
POST /api/sites/generate
```
## Request
```bash theme={null}
curl -X POST https://beta-avallon.onrender.com/api/sites/generate \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "My Website",
"description": "A modern portfolio website for a photographer",
"mode": "full",
"multiPage": true
}'
```
### Request Body
Name of the website
Description of what you want to build
Generation mode: "full" (default) or "minimal"
Whether to generate multiple pages (default: true)
Design style: "modern", "minimal", "bold", etc.
Color scheme preferences
## Response
Whether the request was successful
Object containing HTML files (key: filename, value: HTML content)
ID of the created website
Preview URL for the generated website
### Example Response
```json theme={null}
{
"success": true,
"websiteContent": {
"index.html": "...",
"about.html": "...",
"contact.html": "..."
},
"siteId": "1234567890",
"previewUrl": "https://preview.avallon.site/website-1234567890"
}
```
## Credits
This endpoint uses **1 credit** per website generation.
## Errors
Error message if generation fails
Error code (e.g., "INSUFFICIENT\_CREDITS", "GENERATION\_FAILED")