Skip to main content
POST
Update MCP server

Restrictions

Usage

  • Requires edit rights on the server’s current team: an account-scoped server (team_id=0) can be changed only by the account owner or an admin, a team server only by members of that team (owners and admins included only if they belong to it).
  • server_name, description, transport, command, url, and auth_mode change only when non-empty, and connect_timeout / call_timeout only when non-zero, so these cannot be cleared through this endpoint.
  • args, env, and headers replace the whole value when sent: a key left out of env/headers is removed. For a protected env/headers key, sending the masked value or an empty string keeps the stored secret.
  • When auth_mode is sent, secret_schema is overwritten with the value sent alongside it (empty if omitted). oauth_metadata is cleared when auth_mode or url actually changes, unless a non-empty oauth_metadata is sent.
  • Moving to another team (team_id > 0) requires membership in the destination team and is refused for servers installed from the marketplace; moving to account scope (team_id=0) requires the account owner or an admin. If environments is not sent with a team change, the current runner entries must still be selectable by the caller or the update is rejected.
  • environments: omit (or null) to leave unchanged; send a list to replace it — an empty list clears the restriction back to all environments.
  • The response is the updated server. If a connection field changed, the cached tool list is dropped and fetched again in the background.
  • Every call is recorded in the account audit log.

Authorizations

app_key
string
query
required

APP Key created in the Flashduty console under My → APP Key. Send it as the app_key query parameter or in the Fd-App-Key request header. Its effective access is the intersection of the key's permission scope and the creator's current role permissions. Keep it secret.

Body

application/json

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

server_id
string
required

Target MCP server ID, from the list returned by POST /safari/mcp/server/list.

server_name
string

New name; omitted or empty leaves it unchanged.

Required string length: 1 - 255
description
string

New description; omitted or empty leaves it unchanged.

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

Transport protocol; when switching, also supply the matching fields (command/args/env for stdio, url/headers for sse / streamable-http); omitted or empty leaves it unchanged.

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

New executable command (stdio transport); omitted or empty leaves it unchanged.

args
string[]

Command arguments (stdio transport); replaces the whole list — pass [] to clear, omit to leave unchanged.

env
object

Environment variables (stdio transport); replaces the whole map, so keys left out are removed. For a protected key (see the masking rule on get), sending the masked value or an empty string keeps the stored value. Omit to leave unchanged.

url
string

New server URL (sse / streamable-http transport); omitted or empty leaves it unchanged. A real change also clears oauth_metadata unless a new one is sent.

headers
object

HTTP headers (sse / streamable-http transport); replaces the whole map, with the same masked/empty-value preservation as env; omit to leave unchanged.

connect_timeout
integer

New connection timeout in seconds; omitted or 0 leaves it unchanged (a stored 0 means the 10-second default).

call_timeout
integer

New tool-call timeout in seconds; omitted or 0 leaves it unchanged (a stored 0 means the 60-second default).

auth_mode
enum<string>

New auth mode; omitted or empty leaves it unchanged. Who supplies the credential:

  • shared (default; an empty value behaves the same): one credential stored on the server (env / headers) is used for every caller.
  • per_user_secret: each user stores their own secret, sent in the header named by secret_schema.header_name.
  • per_user_oauth: each user completes their own OAuth authorization; discovery and client registration run on first use.

per_user_secret requires secret_schema with a non-empty header_name; any other value returns InvalidParameter.

Available options:
shared,
per_user_secret,
per_user_oauth
secret_schema
string

New JSON secret schema, e.g. {"header_name":"X-Api-Key"}. Applied only together with a non-empty auth_mode; sent alone it is ignored.

oauth_metadata
string

New JSON OAuth metadata. A non-empty value is stored as sent. When omitted or empty, the stored value is kept unless auth_mode or url changes, in which case it is cleared.

team_id
integer<int64> | null

Reassign team scope: 0 = account-wide (account owner or admin only); >0 = a team the caller belongs to. Servers installed from the marketplace can only move to 0. Omit to leave unchanged.

environments
string[] | null

Execution environments this server is callable from: cloud and/or BYOC runner environment IDs. Omit (null) to leave unchanged; send a list to set it — an empty list clears the restriction back to all environments.

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.