# Hostingsurge Builder API

**Canonical:** https://apis.io/apis/hostingsurge-com/hostingsurge-com-builder-api/  
**Provider:** Hostingsurge — https://apis.io/providers/hostingsurge-com/  
**Base URL:** https://hostingsurge.com/api/v1  
**Documentation:** https://hostingsurge.com/developers

Hostingsurge Builder API is one of 37 APIs that [Hostingsurge](https://apis.io/providers/hostingsurge-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Builder. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

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

## Operations (60 of 120)

| Method | Path | Summary |
|---|---|---|
| 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 |

…and 60 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/hostingsurge-com/openapi/hostingsurge-com-builder-api-openapi.yml
- **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

## Other Hostingsurge APIs (12)

- [Hostingsurge Accelerator API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-accelerator-api/)
- [Hostingsurge Agents API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-agents-api/)
- [Hostingsurge Alerts API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-alerts-api/)
- [Hostingsurge Analytics API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-analytics-api/)
- [Hostingsurge Assistant API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-assistant-api/)
- [Hostingsurge Automation API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-automation-api/)
- [Hostingsurge Backups API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-backups-api/)
- [Hostingsurge Billing API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-billing-api/)
- [Hostingsurge Business API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-business-api/)
- [Hostingsurge Certificates API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-certificates-api/)
- [Hostingsurge Databases API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-databases-api/)
- [Hostingsurge Deployments API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-deployments-api/)

## Tags

Builder

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hostingsurge-com/hostingsurge-com-builder-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hostingsurge-com/.