Skip to main content
PATCH

Authorizations

​
Authorization
string
header
required

Your SLNG consumer API key.

Path Parameters

​
server_id
string<uuid>
required

UUID of the MCP server to update. A server in another organisation or one that is soft-deleted returns 404.

Body

application/json

Fields to change on the MCP server.

Partial update for an MCP server. Only the fields you supply change; omitted fields keep their stored values.

​
name
string | null
Required string length: 1 - 200
​
url_template
string | null

New endpoint URL for the MCP server. Supports {{$NAME}} Vault secret placeholders.

Required string length: 1 - 2000
​
transport
enum<string> | null

New transport for the MCP server, either streamable_http or sse.

Available options:
streamable_http,
sse
​
description
string | null

Optional human-readable description of the MCP server. Omit to keep the current value.

Maximum string length: 500
​
auth
No authentication · object

Send requests to the MCP server without an Authorization header.

​
headers
(Literal header · object | Vault-backed header · object)[] | null

Replacement set of request headers. Each header is a literal value or a Vault secret reference.

Maximum array length: 64

A request header with a fixed, inline value.

​
credentials
(Use an existing Vault secret · object | Create a new Vault secret · object)[] | null

Vault secrets to create or reference for the updated configuration. Every supplied credential name must be referenced.

Maximum array length: 64

Reference a secret already stored in Vault by secret_name.

Response

The updated MCP server.

Stored MCP server record with its configuration and the latest discovered capability state. Secret values and transient credential input never appear here.

​
id
string<uuid>
required
​
organisation_id
string<uuid>
required
​
name
string
required
​
transport
enum<string>
required

Transport used to reach the MCP server: streamable_http for streamable HTTP, or sse for Server-Sent Events.

Available options:
streamable_http,
sse
​
url_template
string
required

Stored endpoint URL for the MCP server. Any {{$NAME}} Vault secret placeholders are kept verbatim and resolved at connection time.

​
auth
No authentication · object
required

Send requests to the MCP server without an Authorization header.

​
revision
integer
required
​
capability_status
enum<string>
required

Health of the MCP server capabilities: unknown (not probed yet), healthy (reachable and tools discovered), unavailable (probe failed or unreachable), invalid (reachable but returned an unsupported contract), or circuit_open (temporarily disabled after repeated failures and retried after a cooldown).

Available options:
unknown,
healthy,
unavailable,
invalid,
circuit_open
​
capability_revision
integer
required
​
description
string | null
​
headers
(Literal header · object | Vault-backed header · object)[]

Stored request headers for the MCP server; each value is inline or resolved from a Vault secret.

A request header with a fixed, inline value.

​
capability_observed_at
string<date-time> | null
​
capability_attempted_at
string<date-time> | null
​
capabilities_hash
string | null
​
capabilities
McpCapabilities · object | null

Tools discovered from the MCP server, with flags for whether discovery was truncated and how many pages were fetched.

​
capability_error_code
string | null
​
capability_error_message
string | null
​
capability_tool_count
integer | null
​
next_refresh_at
string<date-time> | null