Update an MCP Server Definition by internalId

Updates the latest version of the MCP server definition. If the latest version is PUBLISHED, a new IN_PROGRESS version is created and changes are applied to it; PUBLISHED rows are never mutated. Acquires a per-entity lock; returns 409 if held.

Path Parameters
internalId string — REQUIRED

Request Body — REQUIRED
name string New display name. null = don't change.
description string New description. null = don't change.
documentationURL string New documentation URL. null = don't change.
transportProtocol string Possible values: [STDIO, STREAMABLE_HTTP, HTTP_SSE] New transport protocol. null = don't change. If set, the post-apply state must satisfy the transport-shape invariant (stdioCommand for STDIO; externalProviderUrl for STREAMABLE_HTTP / HTTP_SSE).
externalProviderUrl string New external provider URL. null = don't change.
headers object[] New HTTP headers. null = don't change. key string value string id string metadata string
stdioCommand string New STDIO command. null = don't change.
stdioCommandArgs string New STDIO command args. null = don't change.
stdioEnv object[] New STDIO environment variables. null = don't change. key string value string id string metadata string
hasStaticTools boolean Whether this server publishes a static set of tools. null = don't change.
hasDynamicTools boolean Whether this server may dynamically expose additional tools. null = don't change.
permittedAuthMechanisms string[] New auth mechanism IDs. null = don't change. Empty list = explicitly clear.

Responses
200 Returns the updated MCP server definition Schema — OPTIONAL object