v20

OpenAPI 3.1.0raw.githubusercontent.com2026-08-035471202.8 KB
Hosts

Create a host (from a template or a full config)

Creates a host in the project and responds 201 with the new host's detail. Seed the host config one of two ways: pass template (a built-in template id, optional theme) to seed server-side from the live backend host catalog, falling back to the bundled SDK catalog snapshot if the live catalog is unavailable, OR pass config (a full host config v2). Exactly one of template or config is required.

Guest callers are denied (host creation is a write).

post/projects/{projectId}/hosts

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

Request body

OR

Response

The host was created.

idstring required
namestring required
configobject required

Host config v2 DTO. Opaque object; shape mirrors the inspector's host editor.