latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-23174237683.4 KB

9a3b3893f016

Agent1

Catalog10

Conformance runs9

Directory readiness6

Environments10

Eval runs27

Eval suites1

Evals4

Execution2

Export1

Harness1

Hosts7

OAuth1

Plugins2

Primitives4

Projects4

Registry8

Sandbox images11

Scenarios2

Server connections4

Server diagnostics3

Servers4

Swarm insights8

Swarm runs5

Swarms17

Tunnels2

User testing20

Registry

Install a directory server into a project

Writes a servers row and catalog provenance. SUCCESS MEANS INSTALLED, NOT CONNECTED — follow with get_project_server_connection_status and, for OAuth, the browser connect-link handoff. Pass expectedContentHash from GET /registry/directory-servers/{id} to reject a row that moved (TOCTOU). There is no catalog-uninstall route: delete the project server.

post/projects/{projectId}/registry/directory-installs

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

Request body

catalogServerIdstring required

endpointUrlstring

Required for options and tenant endpoint kinds.

expectedContentHashstring

TOCTOU pin from latestContentHash.

Response

Installed or already present (outcome is created or reconnected).

serverIdstring required

serverNamestring required

outcome'created' | 'reconnected' required