> This page is for API Reference & Tools.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.moveworks.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.moveworks.com/_mcp/server.

# Update MCP server

PATCH https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/{id}
Content-Type: application/json

Changes the fields you send and returns the full updated document.

Send only the fields you want to change, plus `version` with the `num` from your last read and a `change_description`. This is a JSON merge-patch: a field you leave out keeps its stored value, `null` clears it, and nested objects merge field by field. Lists of objects merge row by row instead of being replaced, so read the document first and send the whole list back when you reorder or remove rows. Lists of strings, Data Mapper expressions, JSON schemas, `workflow_steps` and `resolver_methods` are replaced whole. The `id` goes in the URL; if you also send `id` in the body it must match.

Reference: https://docs.moveworks.com/api-reference/configuration-api/tool-studio/mcp-servers/update-mcp-server

## Authentication

- `Authorization` header (bearer token, required) — JWT bearer token authentication. Include the Configuration API key in the Authorization header as 'Bearer \<token>'.

## Request

### Path parameters

- `id` (string, required) — The `id` of the MCP server, as returned when it was created or listed.

### Body (application/json)

This endpoint expects a MCPServerPatch.

- `version` (McpServerVersionPatch, required) — Document version. On update, send back the num from your last read.
- `name` (string, optional) — Display name of the MCP server. Must be unique within the organization; up to 128 characters.
- `connector_id` (string, optional) — Connector that provides the MCP server's base URL and authentication. The connector must use an authentication type supported for MCP servers. ID of an existing connector (GET /configurations/v1alpha1/platform/connectors).
- `path` (string, optional) — Path appended to the connector's base URL to reach the MCP endpoint, for example '/mcp'. Must start with '/' when set.
- `enabled` (boolean, optional) — If true, the MCP server is available for use. Defaults to false.
- `description` (string, optional) — Description of what this MCP server does. Up to 1024 characters.
- `launch_config` (LaunchSettings, optional) — Which users the MCP server and its tools are available to. If no audience is set, it is available to all users.
- `tool_confirmation_mode` (enum, optional) — When users must confirm before a tool on this server runs: always, never, or server-guided. Defaults to server-guided, which follows the server's own tool annotations.
  - Allowed values: `TOOL_CONFIRMATION_MODE_UNSPECIFIED`, `TOOL_CONFIRMATION_MODE_ALWAYS`, `TOOL_CONFIRMATION_MODE_NEVER`, `TOOL_CONFIRMATION_MODE_SERVER_GUIDED`

## Response

### 200

The updated MCP server, at its new version

- `id` (string, optional) — Unique identifier of the MCP server, assigned by the server.
- `name` (string, optional) — Display name of the MCP server. Must be unique within the organization; up to 128 characters.
- `connector_id` (string, optional) — Connector that provides the MCP server's base URL and authentication. The connector must use an authentication type supported for MCP servers. ID of an existing connector (GET /configurations/v1alpha1/platform/connectors).
- `path` (string, optional) — Path appended to the connector's base URL to reach the MCP endpoint, for example '/mcp'. Must start with '/' when set.
- `enabled` (boolean, optional) — If true, the MCP server is available for use. Defaults to false.
- `description` (string, optional) — Description of what this MCP server does. Up to 1024 characters.
- `launch_config` (LaunchSettings, optional) — Which users the MCP server and its tools are available to. If no audience is set, it is available to all users.
- `tool_confirmation_mode` (enum, optional) — When users must confirm before a tool on this server runs: always, never, or server-guided. Defaults to server-guided, which follows the server's own tool annotations.
  - Allowed values: `TOOL_CONFIRMATION_MODE_UNSPECIFIED`, `TOOL_CONFIRMATION_MODE_ALWAYS`, `TOOL_CONFIRMATION_MODE_NEVER`, `TOOL_CONFIRMATION_MODE_SERVER_GUIDED`
- `updated_time` (datetime, optional) — When the configuration was last updated.
- `updated_by` (string, optional) — Who last updated the configuration.
- `version` (Version, optional) — Document version. On update, send back the num from your last read.

## Errors

### 400 Bad Request Error

Bad request - the body breaks a rule in the schema (a missing required field, an unknown enum value, an invalid DSL or Data Mapper expression), `version.change_description` is missing, or an id in the body doesn't match the URL

- `error` (ErrorResponseError, required)

### 401 Unauthorized Error

Unauthorized - the `Authorization` header is missing or the token is invalid

- `error` (ErrorResponseError, required)

### 403 Forbidden Error

Forbidden - the API key isn't allowed to change this configuration, or the configuration is frozen for your organization

- `error` (ErrorResponseError, required)

### 404 Not Found Error

Not found - no item with this `id` exists in your organization

- `error` (ErrorResponseError, required)

### 409 Conflict Error

Conflict - `version.num` doesn't match the stored version (someone changed it since your last read; read it again and retry), or the item already exists

- `error` (ErrorResponseError, required)

### 429 Too Many Requests Error

Too many requests - the organization exceeded the Configuration API rate limit. Back off and retry.

- `error` (ErrorResponseError, required)

### 500 Internal Server Error

Internal server error - retry the request

- `error` (ErrorResponseError, required)

## Types

### McpServerVersionPatch

- `num` (integer, required) — Version number set by the server. On update, send the num from your last read; a stale num is rejected as a conflict.
- `change_description` (string, required) — A short note describing this change. Required on every create and update.

### LaunchSettings

- `allow_all` (boolean, optional) — If true, the resource is available to all users. Setting false makes it available to no one; to allow everyone, set true or leave all audience options unset.
- `allowed_users` (EmailList, optional) — Make the resource available only to the listed user emails.
- `blocked_users` (EmailList, optional) — Make the resource available to all users except the listed user emails.
- `allowlist_rule_dsl` (string, optional) — Moveworks DSL rule; the resource is available only to users who match it.
- `analytics_enabled` (boolean, optional) — If true, the resource is marked ready for production and included in analytics.
- `log_redaction_enabled` (boolean, optional) — If true, possibly sensitive data is redacted from logs produced by this resource.

### Version

- `num` (integer, optional) — Version number set by the server. On update, send the num from your last read; a stale num is rejected as a conflict.
- `change_description` (string, optional) — A short note describing this change. Required on every create and update.

### ErrorResponseError

- `code` (string, optional) — A machine-readable error code.
- `message` (string, optional) — What went wrong, and for a rejected field, which rule it broke.

### EmailList

- `email_addrs` (list of string, optional) — User email addresses. Values must be unique.

## Examples

### MCP Servers endpoints_updateMCPServer_example

**Response**

```json
{
  "id": "3f6c1e2a-8b4d-4c7e-9a1f-2d5b6c7e8f90",
  "name": "internal_tools_mcp",
  "connector_id": "6f1c9f0e-6e1a-4b39-9a1e-1c6d0f2b7a55",
  "path": "/mcp",
  "enabled": false,
  "description": "Internal tooling MCP server.",
  "launch_config": {
    "allowed_users": {
      "email_addrs": [
        "jordan.lee@example.com"
      ]
    }
  },
  "tool_confirmation_mode": "TOOL_CONFIRMATION_MODE_SERVER_GUIDED",
  "updated_time": "2026-11-12T18:04:11Z",
  "updated_by": "admin@example.com",
  "version": {
    "num": 3,
    "change_description": "Turn the server off"
  }
}
```

**SDK Code**

```python MCP Servers endpoints_updateMCPServer_example
import requests

url = "https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/id"

headers = {"Authorization": "Bearer <token>"}

response = requests.patch(url, headers=headers)

print(response.json())
```

```javascript MCP Servers endpoints_updateMCPServer_example
const url = 'https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/id';
const options = {method: 'PATCH', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go MCP Servers endpoints_updateMCPServer_example
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/id"

	req, _ := http.NewRequest("PATCH", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby MCP Servers endpoints_updateMCPServer_example
require 'uri'
require 'net/http'

url = URI("https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java MCP Servers endpoints_updateMCPServer_example
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.patch("https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/id")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php MCP Servers endpoints_updateMCPServer_example
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('PATCH', 'https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/id', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp MCP Servers endpoints_updateMCPServer_example
using RestSharp;

var client = new RestClient("https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/id");
var request = new RestRequest(Method.PATCH);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift MCP Servers endpoints_updateMCPServer_example
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/id")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "PATCH"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

### Turn the server off

**Request**

```json
{
  "version": {
    "num": 2,
    "change_description": "Turn the server off"
  },
  "enabled": false
}
```

**Response**

```json
{
  "id": "3f6c1e2a-8b4d-4c7e-9a1f-2d5b6c7e8f90",
  "name": "internal_tools_mcp",
  "connector_id": "6f1c9f0e-6e1a-4b39-9a1e-1c6d0f2b7a55",
  "path": "/mcp",
  "enabled": false,
  "description": "Internal tooling MCP server.",
  "launch_config": {
    "allowed_users": {
      "email_addrs": [
        "jordan.lee@example.com"
      ]
    }
  },
  "tool_confirmation_mode": "TOOL_CONFIRMATION_MODE_SERVER_GUIDED",
  "updated_time": "2026-11-12T18:04:11Z",
  "updated_by": "admin@example.com",
  "version": {
    "num": 3,
    "change_description": "Turn the server off"
  }
}
```

**SDK Code**

```python Turn the server off
import requests

url = "https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/id"

payload = {
    "version": {
        "num": 2,
        "change_description": "Turn the server off"
    },
    "enabled": False
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.json())
```

```javascript Turn the server off
const url = 'https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/id';
const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"version":{"num":2,"change_description":"Turn the server off"},"enabled":false}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Turn the server off
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/id"

	payload := strings.NewReader("{\n  \"version\": {\n    \"num\": 2,\n    \"change_description\": \"Turn the server off\"\n  },\n  \"enabled\": false\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Turn the server off
require 'uri'
require 'net/http'

url = URI("https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"version\": {\n    \"num\": 2,\n    \"change_description\": \"Turn the server off\"\n  },\n  \"enabled\": false\n}"

response = http.request(request)
puts response.read_body
```

```java Turn the server off
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.patch("https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/id")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"version\": {\n    \"num\": 2,\n    \"change_description\": \"Turn the server off\"\n  },\n  \"enabled\": false\n}")
  .asString();
```

```php Turn the server off
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('PATCH', 'https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/id', [
  'body' => '{
  "version": {
    "num": 2,
    "change_description": "Turn the server off"
  },
  "enabled": false
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp Turn the server off
using RestSharp;

var client = new RestClient("https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/id");
var request = new RestRequest(Method.PATCH);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"version\": {\n    \"num\": 2,\n    \"change_description\": \"Turn the server off\"\n  },\n  \"enabled\": false\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift Turn the server off
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [
  "version": [
    "num": 2,
    "change_description": "Turn the server off"
  ],
  "enabled": false
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/mcp-workspace/servers/id")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "PATCH"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```