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

Deploy Website

Publish Modes

The generator of the current website and the publish modes it can use: static, dynamic (only when the render server serves the website) and preview (a build into the demo address).

Get Deployment Status

Get Domain Status

Update Deployment Domain

Check Domain DNS

Own domain: status

The name (pending or connected), the DNS records to set, whether they point at us now, and what the owner can do next: none | waiting_dns | dns_found (no plan yet) | ready (plan, not connected) | connected.

Own domain: save

Remember the name (always allowed, also before paying). With connect=true and the plan that includes own domains, connect it to the project the same way the domain step after payment does.

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.

Own change status

Whether the first publish should first ask for a business name, phone number or logo, which own signals exist, and the values to prefill.

Save own change

Saves the phone number given on the publish screen (into the contact details of the site) and records that the owner made the site theirs.

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.

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.

The project's forward (null when none), its DNS records and redirect counts

Create or update the forward. A new forward on a normal project needs convert_project

Check DNS now; when it points to us, (re)write the vhost and certificate in the background

Remove the forward. The project becomes a normal (free) project again

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

List Archived Layouts

Soft-deleted layouts (archived_at IS NOT NULL) for the management sidebar archive toggle.

Unarchive Layout

Restores a soft-deleted layout and the header/footer/content components (+ component meta) that LayoutsDeleteController cascaded.

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 (header/footer slots) or embedded on pages ([wemasy-menu] / MenuNav blocks), plus 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

List Archived Pages

Soft-deleted pages (archived_at IS NOT NULL). Used by the management sidebar archive toggle so merchants can review and restore pages.

Unarchive Page

Restores a soft-deleted page and the component rows / component meta that PagesDeleteController cascaded. Same project-wide URL uniqueness rules as PagesCreateController. On collision, returns url_conflict + suggested_url WITHOUT restoring, until the client re-calls with confirm_rename=true (and the chosen url).

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.

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.

Search Content

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

List Archived Structure Categories

Flat list (no hierarchy) of soft-deleted categories for the archive UI.

Unarchive Structure Category

Restores the soft-deleted category and its pivot rows. Same project-wide URL uniqueness as create — conflict returns suggested_url without restoring until confirm_rename=true.

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

List Archived Dynamic Structures

Unarchive Dynamic Structure

Restores the soft-deleted post and its category pivot rows. Same project-wide URL uniqueness as create — conflict returns suggested_url without restoring until confirm_rename=true.

Get Dynamic Structure

Edit Dynamic Structure

Delete Dynamic Structure

Create Template

List Templates

List Archived Templates

Soft-deleted content partials (archived_at IS NOT NULL) for the template panel archive toggle.

Unarchive Template

Restores a soft-deleted partial and the components / component meta that TemplatesDeleteController cascaded.

Edit Template

Get Template

Archive Template

Delete Template

Clone a template/partial from one project to another

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