Skip to main content

​
Overview

The Avallon API allows you to programmatically create, modify, and manage websites. Use the API to integrate Avallon into your applications or automate website creation.

​
Base URL

Production: https://beta-avallon.onrender.com
Development: http://localhost:3000

​
Authentication

All API requests require authentication using Firebase tokens: 
Authorization: Bearer <firebase_token>

​
Getting a Token

  1. Sign in to Avallon
  2. Get your Firebase token from localStorage: firebase_token
  3. Include it in the Authorization header

​
Rate Limits

  • Free Plan: 10 requests per minute
  • Starter Plan: 50 requests per minute
  • Growth Plan: 100 requests per minute

​
Response Format

All API responses follow this format: 
{
  "success": true,
  "data": { ... },
  "message": "Operation successful"
}

​
Error Response

{
  "success": false,
  "error": "Error message",
  "code": "ERROR_CODE"
}

​
Status Codes

200 OK

Request successful

201 Created

Resource created successfully

400 Bad Request

Invalid request parameters

401 Unauthorized

Missing or invalid authentication

402 Payment Required

Insufficient credits

404 Not Found

Resource not found

500 Server Error

Internal server error

​
Endpoints

Generate Website

Create a new website from a description

Modify Website

Modify an existing website using AI

Import Website

Import an existing website

Deploy Website

Deploy a website to production

​
SDKs

Currently, Avallon provides a REST API. SDKs for popular languages are coming soon:
  • JavaScript/TypeScript
  • Python
  • Ruby
  • PHP

​
Support

For API support: