v25

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-086580241.1 KB
Hosts

Replace a host's server attachments

Sets the host's required and optional server ids without round-tripping its whole config, and responds with the updated host detail. Preserves every other identity field (computer, harness, built-in tools) and trims per-server connection overrides to the kept set. Requires project admin.

post/projects/{projectId}/hosts/{hostId}/servers

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

hostIdstring required

Host ID, as returned by the project's host list.

Request body

serverIdsstring[] required
optionalServerIdsstring[]

Attached but not required to connect.

Response

The updated host.

idstring required
namestring required
configobject required

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