Hostingsurge

Hostingsurge Builder API

The Builder API from Hostingsurge — 102 operation(s) for builder.

GitHub OpenAPI

Operations 120

POST /builder/previews/{sessionId}/wake Public, no credentials: someone opened a preview link after the preview went to… #
POST /builder/sessions Start a new AI-built project from a prompt: creates a project, seeds the… #
GET /builder/sessions Builder sessions you can see, newest first (active ones by default) #
GET /builder/sessions/{sessionId} One builder session #
PATCH /builder/sessions/{sessionId} Rename a session, archive it (hidden from the default list, its preview… #
POST /builder/sessions/{sessionId}/cancel Stop the running turn: it ends canceled, the files stay as they were before it… #
POST /builder/sessions/{sessionId}/preview/wake Start the live preview again from the current files after it went idle (answers… #
POST /builder/sessions/{sessionId}/preview/keepalive Someone is looking at the preview: postpone its idle shutdown (call about once… #
GET /builder/sessions/{sessionId}/turns Chat turns, newest first (version history) #
GET /builder/sessions/{sessionId}/turns/{turnId}/diff File changes of one turn #
GET /builder/sessions/{sessionId}/files The current file tree #
GET /builder/sessions/{sessionId}/file The content of one file #
POST /builder/sessions/{sessionId}/restore Restore the project to the state right after an earlier turn (recorded as a new… #
POST /builder/sessions/{sessionId}/publish Deploy exactly the version the customer last saw (the session's last commit) to… #
GET /builder/usage Build Credits, tokens and model cost of an organization's finished AI builder… #
GET /builder/sessions/{sessionId}/edits Live editing: what the editor shows (pages and their sections, theme… #
POST /builder/sessions/{sessionId}/edits Live editing: apply edits made in the preview (text, links, pictures, sections… #
POST /builder/sessions/{sessionId}/edits/commit Live editing: save the pending edits as a version now #
POST /builder/sessions/{sessionId}/assets Upload a picture (JPEG, PNG, WebP, GIF, AVIF or SVG, at most 10 MB) as the… #
DELETE /builder/sessions/{sessionId}/assets/{uploadId} Remove a picture the site no longer shows #
GET /builder/sessions/{sessionId}/photos Free photos (CC0, no credit line needed) from Openverse #
POST /builder/sessions/{sessionId}/photos/import Add a free photo from the search to the site's pictures #
POST /builder/sessions/{sessionId}/assets/generate Make a picture with AI from a description (Build Credits); only where AI… #
POST /builder/sessions/{sessionId}/turns/{turnId}/bookmark Bookmark a version as a stable one (or remove the bookmark) #
POST /builder/sessions/{sessionId}/preview/version Show an earlier version in the preview, read-only (turnId null: the current one… #
GET /builder/sessions/{sessionId}/content AI content: languages, pages and their addresses, SEO texts, pictures and what… #
POST /builder/sessions/{sessionId}/content/write AI content: three versions of one text (write, rewrite, shorter, longer… #
POST /builder/sessions/{sessionId}/content/improve AI content: "Improve all texts" of a page or the site, as proposals. #
POST /builder/sessions/{sessionId}/content/check AI content: "Check my texts": spelling, grammar, filler, clichés and claims to… #
POST /builder/sessions/{sessionId}/content/seo AI content: SEO and link-preview texts for pages in one language. #
POST /builder/sessions/{sessionId}/content/alt AI content: alt texts written from the uploaded pictures themselves. #
GET /builder/sessions/{sessionId}/content/translations AI content: the translation table (every text, each language, its state) #
POST /builder/sessions/{sessionId}/content/languages AI content: translate the whole site into one more language (saved as a… #
DELETE /builder/sessions/{sessionId}/content/languages/{lang} AI content: remove a language (saved as a version) #
POST /builder/sessions/{sessionId}/content/translations/update AI content: translate again the texts that need an update (edited ones only… #
POST /builder/sessions/{sessionId}/content/translations/keep AI content: keep translations as they are (up to date) #
PUT /builder/sessions/{sessionId}/content/slugs AI content: a language's page addresses (localized URLs) #
PUT /builder/sessions/{sessionId}/content/glossary AI content: the words the AI never translates #
GET /builder/sessions/{sessionId}/quality Site checks: the latest check (six score cards and every finding in plain… #
POST /builder/sessions/{sessionId}/quality/checks Check the site as it is now: the real publish build and its size, every page… #
GET /builder/sessions/{sessionId}/quality/checks/{runId} One site check #
PUT /builder/sessions/{sessionId}/quality/settings Automatic SEO (every page as real HTML with sitemap.xml, robots.txt, llms.txt… #
POST /builder/sessions/{sessionId}/runtime-errors Runtime errors the live preview reported (the dashboard forwards them): kept… #
POST /builder/sessions/{sessionId}/runtime-errors/resolve Clear the preview's runtime errors (all, or these ids) #
GET /builder/sessions/{sessionId}/modes Agent modes of a session: the mode of recent turns, its plans, the free Chat… #
PATCH /builder/sessions/{sessionId}/plans/{planId} Edit a plan: the whole step list in its new order (tick or untick, rename, add… #
POST /builder/sessions/{sessionId}/plans/{planId}/build Build a plan: marks it building and returns its ticked steps as Build messages… #
GET /builder/sessions/{sessionId}/knowledge "About my business" of this project and the team's guidelines for every site… #
PUT /builder/sessions/{sessionId}/knowledge Save "About my business" (project) and, for owners and admins, the team's… #
POST /builder/sessions/{sessionId}/knowledge/propose Facts about the business the customer stated in this chat that are not saved… #
POST /builder/directions Three design directions (palette, font pairing, hero layout, corners) for a… #
PUT /builder/sessions/{sessionId}/look The look the session's next Build turn applies exactly (colors of both schemes… #
DELETE /builder/sessions/{sessionId}/look Forget the picked look: the next Build turn keeps the site's own look #
POST /builder/sessions/{sessionId}/references Show the builder a picture (PNG, JPEG, WebP, GIF, AVIF, at most 10 MB) or a… #
GET /builder/sessions/{sessionId}/references Pictures and documents shown to the builder this week #
POST /builder/sessions/{sessionId}/references/url A picture of a public web page the customer likes (look and structure only… #
POST /builder/sessions/{sessionId}/references/figma A Figma frame (paste its link) as a picture with its styles. #
GET /builder/sessions/{sessionId}/references/{referenceId}/image The stored picture (WebP) #
DELETE /builder/sessions/{sessionId}/references/{referenceId} Remove a picture or document shown to the builder #
GET /builder/figma Whether Figma is set up here and connected for you #
DELETE /builder/figma Disconnect your Figma account #
POST /builder/figma/connect Start connecting your Figma account: open connectUrl (valid for 10 minutes)… #
GET /builder/figma/callback Figma sends the member back here after they allowed (or refused) access… #
GET /builder/sessions/{sessionId}/backend The site backend of an AI-built site: collections, forms, sign-in, files, AI… #
POST /builder/sessions/{sessionId}/backend/confirm Apply the waiting steps of backend.json (they remove data, which is kept 30… #
POST /builder/sessions/{sessionId}/backend/delete Delete everything the site stores (members, rows, files, form messages) at once… #
GET /builder/sessions/{sessionId}/backend/collections/{collection}/rows Rows of a collection (every field, private ones too) #
POST /builder/sessions/{sessionId}/backend/collections/{collection}/rows Add a row #
PATCH /builder/sessions/{sessionId}/backend/collections/{collection}/rows/{rowId} Change cells of a row (null clears one) #
DELETE /builder/sessions/{sessionId}/backend/collections/{collection}/rows/{rowId} Delete a row (it can be brought back for 30 days) #
POST /builder/sessions/{sessionId}/backend/collections/{collection}/rows/{rowId}/restore Bring back a deleted row #
GET /builder/sessions/{sessionId}/backend/members The site's members (people with an account on the site) #
GET /builder/sessions/{sessionId}/backend/members/test-code The production smoke test only: the last sign-in code sent to an address (404… #
PATCH /builder/sessions/{sessionId}/backend/members/{userId} Block or unblock a member, or make them a site admin #
DELETE /builder/sessions/{sessionId}/backend/members/{userId} Delete a member's account (their rows stay) #
POST /builder/sessions/{sessionId}/backend/members/{userId}/reset Sign a member out everywhere and remove their password (they sign in with an… #
GET /builder/sessions/{sessionId}/backend/files The site's files #
POST /builder/sessions/{sessionId}/backend/files Add a file (the request body; a picture for an image cell) #
DELETE /builder/sessions/{sessionId}/backend/files/{fileId} Delete a file (it can be brought back for 30 days) #
POST /builder/sessions/{sessionId}/backend/files/{fileId}/restore Bring back a deleted file #
GET /builder/sessions/{sessionId}/backend/submissions Stored form messages, newest first #
GET /builder/sessions/{sessionId}/backend/submissions.csv Stored form messages as a CSV file (UTF-8, for spreadsheets) #
PATCH /builder/sessions/{sessionId}/backend/submissions/{submissionId} Mark a message read or unread #
DELETE /builder/sessions/{sessionId}/backend/submissions/{submissionId} Delete a message (it can be brought back for 30 days) #
POST /builder/sessions/{sessionId}/backend/submissions/{submissionId}/restore Bring back a deleted message #
GET /builder/sessions/{sessionId}/backend/log The last calls of the site's visitors to its backend (no addresses, no contents) #
GET /builder/sessions/{sessionId}/collab Draft, GitHub, comments and who is building: the workspace's top bar in one call #
POST /builder/sessions/{sessionId}/collab/presence Tell the others what you look at (page, selected element, view) and what you… #
GET /builder/sessions/{sessionId}/code Every file of the current version, and whether you may edit them #
PUT /builder/sessions/{sessionId}/code Save code changes as one version (0 Build Credits): committed, previewed, then… #
GET /builder/sessions/{sessionId}/code/check The preview's current problems, on files and lines #
GET /builder/sessions/{sessionId}/comments Comment threads, open ones first (anchors resolved again against the current… #
POST /builder/sessions/{sessionId}/comments Start a thread (pinned to an element or a point of a page) or reply; @name… #
PATCH /builder/sessions/{sessionId}/comments/{threadId} Resolve a thread or open it again #
DELETE /builder/sessions/{sessionId}/comments/{commentId} Delete your comment (owners and admins: any) #
GET /builder/sessions/{sessionId}/comments/{threadId}/prompt "Send to AI": the thread as a chat message #
GET /builder/sessions/{sessionId}/members Teammates who can be @mentioned #
DELETE /builder/sessions/{sessionId}/share-links/{linkId} Switch a link off (open previews close within two hours) #
POST /builder/sessions/{sessionId}/remix A copy of the site in a new project (files, never data or orders) #
POST /builder/remix/{token} Copy a site someone shared with a remix link into your team #
POST /builder/sessions/{sessionId}/org-template Save the site as a starting point in your team's gallery #
GET /builder/org-templates Your team's own templates #
POST /builder/org-templates/{templateId}/sessions Start a new site from one of your team's templates #
DELETE /builder/org-templates/{templateId} Remove a template from the gallery (sites made from it stay) #
GET /builder/sessions/{sessionId}/drafts The site's drafts, newest first #
POST /builder/sessions/{sessionId}/drafts Try changes in a draft: its own chat, code and preview on a branch; the site… #
GET /builder/drafts/{draftId}/compare Both previews and the files the draft changed #
POST /builder/drafts/{draftId}/keep Take the draft into the site (one version; lines both changed are finished by… #
POST /builder/drafts/{draftId}/discard Close the draft without changing the site #
GET /builder/sessions/{sessionId}/github The site's GitHub link and whether both sides are in step #
PUT /builder/sessions/{sessionId}/github Keep the site in sync with a repository branch: every version becomes a commit… #
DELETE /builder/sessions/{sessionId}/github Stop syncing (nothing is deleted on either side) #
GET /builder/sessions/{sessionId}/github/installations GitHub accounts connected to the team (Settings → Git) #
GET /builder/sessions/{sessionId}/github/repositories Repositories of a connected account #
GET /builder/sessions/{sessionId}/github/branches Branches of the linked repository #
POST /builder/sessions/{sessionId}/github/branch Follow another branch (the builder takes its code; create: start it from the… #
POST /builder/sessions/{sessionId}/github/sync Sync now (it also happens on every push and every minute) #
POST /builder/imports Import a Vite + React repository (a Lovable or Bolt export) as a new site… #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/hostingsurge-com/openapi/hostingsurge-com-builder-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-builder-visual-op-schema.json
📊
JSONSchema
https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-policy-templates-input-body-schema.json
📊
JSONSchema
https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-pending-changes-input-body-schema.json
📊
JSONSchema
https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-confirm-prices-input-body-schema.json
📊
JSONSchema
https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-collection-input-body-schema.json
📊
JSONSchema
https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-create-shop-input-body-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/hostingsurge-com:hostingsurge-com-builder-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

hostingsurge-com-builder-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Hostingsurge Platform Builder API
  version: 1.0.0
  description: 'Deploy and operate projects on Hostingsurge: Git/upload/Docker/WordPress projects, deployments, logs, environment variables, domains and databases. Errors are {"error":{"code","message","details?"}}.'
servers:
- url: /api/v1
  description: Same origin as the dashboard, e.g. https://hostingsurge.com/api/v1
security:
- bearerAuth: []
- sessionCookie: []
tags:


# --- truncated at 32 KB (1659 KB total) ---
# Full source: https://artifacts.apis.io/hostingsurge-com/openapi/hostingsurge-com-builder-api-openapi.yml