Website Builder API

Approve Theme Version

Requires superadmin access. Approves a theme version (project), allowing it to appear in the marketplace. Requires admin privileges.

Reject Theme Version

Requires superadmin access. Rejects a theme version (project), preventing it from appearing in the marketplace. Requires admin privileges and a rejection reason.

List All Themes

Requires superadmin access. Returns theme versions (projects) with pagination and counts for all statuses. Requires admin privileges.

Create Block

List Blocks

Get Block

Edit Block

Delete Block

Set Block Content

Create Component

Note: This endpoint is not used anywhere currently.

Add Component to Block

Change Component Type

Delete Component

Set Component Content

Update Component Order

Duplicate Component

Unlink Component

When a component is linked to a template (has partial_partial meta), this endpoint will: 1. Copy all template content (custom fields config, code) to the component 2. Remove the template link (partial_partial meta) 3. Component becomes independent with its own copy of data

Convert to Template

This is the inverse of the Unlink operation: 1. Creates a new Partial (reusable template) with custom='custom_template' 2. Copies the component's data (code, meta, custom_fields) into a PartialsComponents child 3. Updates the original component to become a templatePartial linked to the new template

Paste Component

Export Component

Import Component

Update Custom Fields

Download a specific website version with signature validation

URL format: /download/{websiteId}/{versionId}?signature={hmac}&expires={timestamp} PAUSE/RESUME SUPPORT: - Browser: Automatic pause/resume support via Range headers - Envoy wget: Use `wget -c URL` for continue/resume - Envoy curl: Use `curl -C - -o file.zip URL` for continue/resume HEADERS: - Accept-Ranges: bytes (enables pause/resume) - Content-Type: application/zip - Cache-Control: public, max-age=3600 (1 hour cache)

Deploy Website

Get Deployment Status

Get Domain Status

Update Deployment Domain

Check Domain DNS

Reset Deployment

Cancel Deployment

Get Publish Data

Returns all data needed for the publish popup: - Domain information (wemasy/custom/none) - Versions list with current version (from database) - Deployment status and logs (from Redis + database) - Current action type (generate/generate-deploy) PERFORMANCE: Database-only queries, no filesystem reads

Rollback Website to Previous Version

ARCHITECTURE: - Local environment: Direct filesystem access via WebsiteVersionManager - Production: Remote symlink update via SSH on Generator server Rolls back the website to a specific version by updating the symlink and recording the deployment time in the database.

Download a specific website version

Download Deployment Logs or Results

Setup Wemasy Domain

Saves wemasy domain to projects table and optionally switches to it

Switch Domain Type

Switches active domain between custom and wemasy

Check DNS Propagation (API Endpoint)

Checks immediately and dispatches background job for automatic checking if not verified

Confirm DNS Records Added

Called when user clicks "I've added the DNS records" in the publish popup. Sets dns_records_added_at = now() so the DNS setup screen is hidden and the user can proceed with deployment. Also dispatches a background job to check DNS propagation automatically. When propagation is confirmed, dns_verified will be set to '1'.

Get DNS Settings

Returns the DNS records needed for the custom domain, along with the current DNS verification status.

Get File Upload Signed URL

Get Uploaded Files

Delete Uploaded File

Get Large File Upload Signed URL

Get Large Uploaded Files

Delete Large Uploaded File

Create Layout

Create Layout from Theme

POST /api/services/websites/v1/layouts/create-from-theme

List Layouts

Edit Layout

Get Layout

Update Layout Templates

Archive Layout

Delete Layout

List Menus

Menus Get

Edit Menu

Create Menu

Delete Menu

List Pages

Create Page

Create Page from Source (Theme or Infrastructure)

POST /api/services/websites/v1/pages/create-from-source

Get Page

Edit Page

Update Page Template

Archive Page

Delete Page

Duplicate Page

Export Page

Import Page

Get Secured Page Designer

Get Page Designer Data

Duplicate Project

POST /api/services/websites/v1/projects/duplicate Creates a complete duplicate of the source project with all related data. Only accessible by super administrators.

Handle Redirection

Submit Form

Download Signed File

Report Page Not Found

Search Content

Register Onboarding User

Rate limit: 100 requests per minute.

Confirm Onboarding User

Rate limit: 100 requests per minute.

Resend Verification Email

Get Product Pricing List

Get Product Pricing List

Get All Available Pages

Returns all indexable content (pages, structures, webshop items) where no_index is 0 or null

List Forms

Get all available Google Fonts

Manually trigger thumbnail regeneration for a page, template, or layout

Runs after the HTTP response is sent (no queue worker required). Rate limit: 5 requests per project per 10 minutes. POST /api/services/websites/v1/thumbnails/regenerate

Get count of scheduled structure items

Create Structure

List Structures

Get Structure

Edit Structure

Delete Structure

Create Structure Category

List Structure Categories

Get Structure Category

Edit Structure Category

Delete Structure Category

Create Dynamic Structure

List Dynamic Structures

Get Dynamic Structure

Edit Dynamic Structure

Delete Dynamic Structure

Create Template

List Templates

Edit Template

Get Template

Archive Template

Delete Template

Get Theme Marketplace - Browse available themes

Returns one theme per family with latest version details

Get Template Library - Theme templates for Plus button

GET /api/v1/templates/library Returns theme templates for the Plus button modal in page builder. Shows templates from installed themes (grouped by theme). Infrastructure templates are now loaded from /templates/all endpoint. Decision 14: Template Library Integration

Get Theme Marketplace - Browse available themes

Returns one theme per family with latest version details

Get Pages Library - Theme and infrastructure pages for creation

POST /api/services/websites/v1/pages/library

Preview Theme Installation Data (Pages and Structures)

POST /api/services/websites/v1/themes/installation-preview

Get Theme Layouts for Creation

POST /api/services/websites/v1/themes/layouts-for-creation

Uninstall Theme - Remove theme installation from project

POST /api/services/websites/v1/themes/uninstall Handles two installation modes differently: - MANUAL: Simply deletes the project_themes record - SAMPLE_DATA: Returns error (TODO: Future implementation will handle page/layout cleanup)

Install Theme

POST /api/services/websites/v1/themes/install MODE 1 - MANUAL INSTALLATION: - Copies NOTHING during installation - Only creates project_themes pivot record (registers theme) - Layouts shown in popup when user creates layout: "From scratch" or "Get from theme" - Layouts copied on-demand only when user selects them MODE 2 - SAMPLE DATA INSTALLATION: - Copies user-selected pages + their associated layouts + content - Images replaced with placeholders using ThemeCloningService - Quick start approach

List Installed Themes

POST /api/v1/themes/installed Returns all themes installed in the current project with their metadata, version information, and installation details. Supports minimal flag for lightweight responses: - minimal=true: Returns only theme name, version number, image, theme_id, version_id, is_active - minimal=false (default): Returns full theme data with stats and metadata

Get Version History for Theme (Marketplace)

POST /api/services/websites/v1/themes/versions Returns approved, production-ready versions for marketplace display. Filters out dev versions, draft versions, and rejected versions. Each version is a separate project linked by parent_project_id.

Get Single Version Detail

POST /api/services/websites/v1/themes/version/detail Returns details for a specific theme version by version_id. Used for installation modals where only one version's info is needed.

Get Version History for Theme Owner/Publisher

POST /api/services/websites/v1/themes/versions/manage Returns ALL versions for a theme (including dev, draft, pending, rejected). This is specifically for the theme owner to manage their versions. Unlike the marketplace API, this shows everything.

Update Selected Theme Version

POST /api/services/websites/v1/themes/versions/select Stores the user's selected theme version in user meta. When no version is selected, the system will use the first version (ordered desc).

Create New Theme Version - Full Project Duplication with Dev Mode

POST /api/services/websites/v1/themes/versions/create Creates a new version by duplicating the entire source project. Each version is an independent project with complete isolation. Dev Mode (Optional - 5% of advanced users): - When is_dev=true, only 'status' and 'theme_id' required - Dev versions NOT shown in marketplace - Only ONE dev version allowed per theme lineage - Only updates: theme_status, is_dev (inherits other fields from source) Production Version: - When is_dev=false or not provided, ALL marketplace fields required - Requires: version_name, description, theme_description, category, main_image, screenshots - Updates all marketplace metadata - Status 'draft' = work in progress, 'publish' = submit for admin approval

Resubmit Rejected Theme Version

POST /api/services/websites/v1/themes/versions/resubmit Updates a rejected or draft theme version and resubmits for approval. Cannot change: source_project_id, version Can update: status, theme_short_description, theme_description, release_notes, category, tags, main_image, screenshots

Edit Draft Theme Version

POST /api/services/websites/v1/themes/versions/edit Updates a draft theme version's marketplace metadata without changing approval status. Cannot change: source_project_id, version Can update: theme_short_description, theme_description, release_notes, category, tags, main_image, screenshots

Cancel Theme Version Submission

POST /api/services/websites/v1/themes/versions/cancel-submission Cancels a pending submission by reverting the theme version back to draft status. Sets theme_status = 'draft' and approval_status = NULL.

Delete Theme Version

POST /api/services/websites/v1/themes/versions/delete Deletes a theme version by soft-deleting the project. Only draft versions can be deleted. Cannot delete versions that are installed by any project or have child versions.

Deprecate Theme Version

POST /api/services/websites/v1/themes/versions/deprecate Marks a published theme version as deprecated by setting theme_status = 'deprecated'. Only versions with approval_status = 'approved' can be deprecated.

Get Website

Update Website Customization

Get Reuseable Customization

Create Website