Skip to main content
POST
Update MCP server

Restrictions

Usage

  • Masked secret values in env/headers are preserved — sending the masked value back does not overwrite the stored secret.
  • environment_kind/environment_id are independent partial-update fields: omit both to leave the runner binding unchanged; set either to change it, subject to the same byoc-or-empty constraint as create.
  • Changing team_id requires reassignment permission on the destination team; if the runner binding is left unchanged, it must still be selectable by the caller under the new team or the update is rejected.
  • Every call is recorded in the account audit log.

Authorizations

app_key
string
query
required

App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.

Body

application/json

Partial update of an MCP server. Omit a field to leave it unchanged.

server_id
string
required

Target MCP server ID.

server_name
string

New name.

Required string length: 1 - 255
description
string

New description.

Required string length: 1 - 1024
transport
enum<string>

Transport protocol.

Available options:
stdio,
sse,
streamable-http
command
string

Executable command (stdio transport).

args
string[]

Command arguments (stdio transport).

env
object

Environment variables (stdio transport).

url
string

Server URL (sse / streamable-http transport).

headers
object

HTTP headers (sse / streamable-http).

connect_timeout
integer

Connection timeout in seconds. 0 = default (10s).

call_timeout
integer

Tool-call timeout in seconds. 0 = default (60s).

auth_mode
string

Authentication mode: shared (default), per_user_secret, or per_user_oauth.

secret_schema
string

JSON secret schema; required when auth_mode=per_user_secret.

oauth_metadata
string

JSON OAuth metadata; reserved for per_user_oauth.

team_id
integer<int64> | null

Reassign team scope: 0 = account-wide; >0 = team. Omit to leave unchanged.

environment_kind
string | null

Reassign the runner binding: byoc (with environment_id) or empty string to reset to automatic selection. Omit (null) to leave the current binding unchanged.

environment_id
string | null

Runner ID paired with environment_kind=byoc. Omit (null) to leave the current binding unchanged.

allow_insecure_oauth_http
boolean | null

Allow OAuth token exchange over plaintext HTTP. Omit to leave unchanged.

allow_insecure_tls_skip_verify
boolean | null

Skip TLS certificate verification. Omit to leave unchanged.

Response

Success

Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.

request_id
string
required

Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

Error payload inside the response envelope. Present only on non-2xx responses.

data
object

An MCP server (connector) registered on the account.