v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-305398191.8 KB
servers

Create a server

Create a new server. Idempotent — returns success if the server already exists and is owned by the caller.

put/servers/{qualifiedName}

Path parameters

qualifiedNamestring required

The server's qualified name (e.g. 'namespace/server' or 'namespace' for namespace-only servers). Use %2F to encode the slash.

Request body

displayNamestring
descriptionstring

Example request

{
  "displayName": "My Server",
  "description": "A simple server"
}

Response

Server created successfully

namespacestring required
serverstring required
displayNamestring required
descriptionstring required
createdAtstring required

Example response

{
  "namespace": "myorg",
  "displayName": "My Server",
  "description": "A simple server",
  "createdAt": "2024-01-01T00:00:00.000Z"
}