Website Builder API

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 Auto-Publish Schedule

Returns the current auto-publish schedule configuration and the outcome of the most recent scheduled run for the current project's website.

Update Auto-Publish Schedule

Saves the auto-publish schedule configuration for the current project's website. Set schedule_enabled=false to pause the schedule without losing the config.

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

Where a form is embedded (pages, templates/layouts, partials)

Clone a form from one project to another

Deep-copies the form post + `code` JSON (modern) or form_items (legacy). Idempotent by `base_post_id`.

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

Clone a layout from one project to another

Deep-copies the layout + all child templates (header/footer/content) + their components + meta + S3 thumbnails. Idempotent by `base_post_id` — re-running returns the existing clone unless `force_new=true`.

List Menus

Menus Get

Edit Menu

Create Menu

Delete Menu

Where a menu is assigned (pages, layouts/templates, partials)

Clone a menu from one project to another

Deep-copies the menu post + its `code` JSON. Idempotent by `base_post_id`: re-running returns the existing clone with refreshed `code` instead of duplicating.

List Page Not Found Records

Returns paginated 404 records for the current website, sorted by hit count (high impact first).

Delete Page Not Found Record

Soft-deletes a 404 monitoring record.

List Pages

Get Page Sections Summary

Returns a lightweight summary of all sections (components) on a page. Each section includes its ID, position order, type, and a label. Labels are resolved from: template_title meta, partial name (for templatePartial), first heading in content, or fallback to "Section N".

Get Section Blocks Summary

Returns a lightweight summary of top-level blocks inside a section component. Only shows the first level of blocks — nested blocks inside columns, sliders, or accordions are not included. For nested editing, use the visual designer.

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

Clone a page from one project to another (with its layout)

Deep-copies the page + components + meta + S3 thumbnails. When `clone_layout=true` (default) the source page's layout is cloned to the target FIRST, then the new page's parent_id is wired to the cloned layout's id.

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.

Export a project's full hierarchy, categorised by product

Returns: { project, sitebuilder: {customization, layouts, templates, pages, menus, structures}, forms: {forms}, webshop: {...}, manifest, exported_at }

Import encrypted state archive into a project. Dispatches ImportWebsiteStateJob for async processing

Import a project tree into a target project

Pushes the full sitebuilder hierarchy (customization + layouts + templates + pages + menus + structures + forms) from a source project to a target. Per-phase counts and idempotent across re-runs via `base_post_id` (sitebuilder) and `identifier` (structures).

Compare an uploaded encrypted state archive against a live project

Accepts a `.wemasy` file upload + decryption key, decrypts, and returns per-item diff status (new/changed/unchanged/conflict).

Bulk-upsert project metas (filtered safe-keys)

Applies a `metas` map to a target project. Filters out billing, integration tokens, deployment state, and other per-project keys by default — see `DEFAULT_BLOCKED_PREFIXES`. Additive: keys not in the payload are untouched on the target.

Handle Redirection

Submit Form

Issue Captcha Challenge

Public, unauthenticated endpoint the ALTCHA widget fetches (via `challengeurl`) on every form render. Returns the bare, signed challenge JSON — NOT wrapped in the standard ApiResponse envelope — because the widget expects the provider's native shape ({ algorithm, challenge, maxnumber, salt, signature }). Cheap by design: a single HMAC operation, no database writes. The HMAC secret never leaves the server. Route-level throttling guards against abuse.

Download Signed File

Report Page Not Found

Registers a 404 hit for monitoring. If the URL was already reported, increments the hit counter. Rate limited to 2 reports per IP per day (silently ignores excess).

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

Clone a structure (definition + posts + categories) across projects

Deep-copies the full content tree of a structure type. Idempotent by (website_id, identifier). Posts match on `unique_identifier`/`url`; categories match on `url`/`title`.

Batch Create/Update Structure Categories

Sync batch support: if sync_batch is provided, all categories for this website+type get sync_batch=NULL first, then each synced category gets the batch value. Post-sync cleanup archives categories with NULL sync_batch.

Sync Cleanup — Archive categories not touched in the current sync batch

Create Structure Category

List Structure Categories

Get Structure Category

Edit Structure Category

Delete Structure Category

Batch Create/Update Dynamic Structures

Accepts an array of items. Each item with 'id' is updated, items without 'id' are created. Runs in a single transaction for performance (~50x faster than individual calls). Security: validates every item's fields, scopes all queries to the authenticated project, and validates URL uniqueness.

Sync Cleanup — Archive items not touched in the current sync batch

After a sync, call this with the sync_batch timestamp. Items where sync_batch IS NULL (not touched) get archived.

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

Clone a template/partial from one project to another

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.

List All Redirections

Returns paginated redirections for the current website with search and sorting.

Get Redirection

Returns a single redirection by ID for the current website.

Create Redirection

Creates a new URL redirection for the current website.

Edit Redirection

Updates an existing URL redirection for the current website.

Delete Redirection

Soft-deletes a URL redirection for the current website.

Get Website

Update Website Customization

Get Reuseable Customization

Create Website