Skip to main content
PUT
Create a new version of an MCP server

Authorizations

Authorization
string
header
required

JWT token (USER, AGENT, or SERVICE auth)

Path Parameters

mcpServerId
string<uuid>
required

Body

application/json
version
string
required

New version (must be strictly greater than the current head)

reason
string

Optional explanation of why this edit was made

name
string
description
string
serverUrl
string
visibility
enum<string>
Available options:
PUBLIC,
INTERNAL,
PRIVATE
transport
enum<string>
Available options:
STREAMABLE_HTTP,
SSE,
REST
healthCheckUrl
string
documentationUrl
string
openApiSpec
string

Replacement OpenAPI 3.x document for kind=OPENAPI MCPs; ignored on inherit-from-predecessor when null, rejected for kind=REMOTE_PROXY MCPs.

tags
string[]

Optional user-defined tags; when omitted, tags are inherited from the current head version

Response

200 - */*

OK

mcpServerId
string<uuid>
name
string
description
string
relayServerUrl
string
serverUrl
string
transport
enum<string>
Available options:
STREAMABLE_HTTP,
SSE,
REST
protocolVersion
string
visibility
enum<string>
Available options:
PUBLIC,
INTERNAL,
PRIVATE
authDetails
object

Resolved auth credentials for a subscription. Secret values are encrypted at rest.

status
string
subscriptionCount
integer<int32>
metrics
object
kind
enum<string>
Available options:
REMOTE_PROXY,
OPENAPI
version
string
versionCreatedAt
string<date-time>