Websites API

List all your websites.

Response

{
  "success": true,
  "data": [
    {
      "id": "uuid",
      "name": "My Agency",
      "subdomain": "myagency",
      "landing_prefix": "lp",
      "homepage_type": "page",
      "is_active": true,
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-04-01T10:00:00Z"
    }
  ],
  "count": 3
}

Get details of a specific website.

Create a new website with AI-generated pages. Synchronous - may take 30-120 seconds.

Request Body

{
  "name": "My Agency Website",
  "subdomain": "myagency",
  "domain": "www.myagency.com",
  "pages": [
    {
      "slug": "",
      "prompt": "Create a professional homepage for a digital marketing agency",
      "is_homepage": true
    },
    {
      "slug": "about",
      "prompt": "Create an about page with company history and team",
      "title": "About Us"
    }
  ]
}

Parameters

Response

{
  "success": true,
  "data": {
    "project_id": "uuid",
    "name": "My Agency Website",
    "subdomain": "myagency",
    "urls": {
      "subdomain": "https://myagency.escalateflow.com",
      "custom_domain": "https://www.myagency.com"
    },
    "pages": [
      {"slug": "", "title": "Home", "status": "success"},
      {"slug": "about", "title": "About Us", "status": "success"}
    ]
  }
}

Create a website asynchronously. Returns immediately with a job ID for polling.

Same request body as POST /projects/

Response

{
  "success": true,
  "data": {
    "job_id": "uuid",
    "status": "pending"
  },
  "message": "Website generation started. Poll /api/v1/jobs/{job_id}/ for status."
}

List all pages of a website.

Response

{
  "success": true,
  "data": [
    {
      "id": "uuid",
      "slug": "about",
      "title": "About Us",
      "is_homepage": false,
      "status": "published",
      "created_at": "2026-01-01T00:00:00Z"
    }
  ]
}

Add a new AI-generated page to an existing website.

Request Body

{
  "slug": "pricing",
  "prompt": "Create a pricing page with three tiers: Starter, Growth, Scale",
  "title": "Pricing"
}

Response

{
  "success": true,
  "page": {
    "slug": "pricing",
    "title": "Pricing",
    "url": "https://mysite.escalateflow.com/pricing",
    "status": "success"
  }
}

Edit a specific section of a page using AI. The AI regenerates just that section while maintaining page consistency.

Request Body

{
  "section_id": "hero",
  "prompt": "Change the headline to 'Grow Your Business 10x' and make the CTA button green"
}

Response

{
  "success": true,
  "message": "Section \"hero\" updated successfully",
  "page_url": "https://mysite.escalateflow.com",
  "section_id": "hero"
}

Common Section IDs

Retrieve current website settings.

Update website settings.

Request Body

{
  "name": "Updated Website Name",
  "primary_color": "#3B82F6",
  "head_scripts": "<script>...</script>",
  "footer_scripts": "<script>...</script>",
  "default_meta_title_suffix": " | My Brand",
  "default_meta_description": "Welcome to our website"
}

Settings Fields

Get or update the Style Kit (colors, typography, buttons). These generate CSS custom properties on every page.

Response / Request Body

{
  "success": true,
  "data": {
    "colors": {
      "primary": "#EF6A00",
      "secondary": "#3d3d3d",
      "accent": "#10b981",
      "background": "#ffffff"
    },
    "typography": {
      "heading_font": "Inter",
      "body_font": "Inter"
    },
    "buttons": {
      "primary": {
        "bg": "#EF6A00",
        "text": "#ffffff",
        "border_radius": "8px"
      }
    }
  }
}

Extract a style kit from an existing website URL.

{"url": "https://example.com"}

Get SEO settings for a website.

Get or update the full style configuration.

CSS Variables Generated

Your Style Kit generates these CSS custom properties on every page:

:root {
  --ef-color-primary: #EF6A00;
  --ef-color-secondary: #3d3d3d;
  --ef-color-accent: #10b981;
  --ef-color-background: #ffffff;
  --ef-font-heading: 'Inter', sans-serif;
  --ef-font-body: 'Inter', sans-serif;
  --ef-btn-primary-bg: #EF6A00;
  --ef-btn-primary-text: #ffffff;
  --ef-btn-primary-radius: 8px;
  --ef-container-max-width: 1200px;
  --ef-section-padding: 4rem 0;
}

List all custom domains for a website.

Add a custom domain.

{"domain": "www.example.com"}

Get, update, or delete a specific domain.

List all CMS pages.

Create a new CMS page.

{
  "title": "About Us",
  "slug": "about",
  "html": "<section>...</section>",
  "status": "published",
  "show_in_menu": true,
  "is_homepage": false
}

Get, update, or delete a specific page.

Reorder pages in the menu.

{"pages": [{"id": "uuid", "menu_order": 0}, {"id": "uuid", "menu_order": 1}]}

Get the navigation structure.

Update navigation structure.

{
  "structure": [
    {"label": "Home", "url": "/"},
    {"label": "About", "url": "/about"}
  ],
  "auto_generate": false
}

Auto-regenerate navigation from existing pages.

Get or update the navbar HTML.

{"html": "<nav class=\"...\">...</nav>"}

Get or update the footer HTML.

{"html": "<footer class=\"...\">...</footer>"}