Clients

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

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

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

post/projects/{projectId}/clients

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

Request body

OR

Response

The client was created.

idstring required
namestring required
configIdstring

The concurrency token — see Client.configId.

configobject required

Client config v2 DTO. Opaque object; shape mirrors the inspector's client editor.

ownerScopeobject nullable required
hasComputerboolean
createdAtnumber

Unix epoch milliseconds.

updatedAtnumber

Unix epoch milliseconds.

Changes