Update MCP server

import requests

url = "https://api.datagrid.com/v1/organization/mcp-servers/{server_id}"

payload = {
    "name": "<string>",
    "base_url": "<string>",
    "transport": "http",
    "icon_url": "<string>",
    "protocol_version": "<string>",
    "authorization_secret_id": "<string>",
    "authorization": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    base_url: '<string>',
    transport: 'http',
    icon_url: '<string>',
    protocol_version: '<string>',
    authorization_secret_id: '<string>',
    authorization: '<string>'
  })
};

fetch('https://api.datagrid.com/v1/organization/mcp-servers/{server_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request PATCH \
  --url https://api.datagrid.com/v1/organization/mcp-servers/{server_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "base_url": "<string>",
  "transport": "http",
  "icon_url": "<string>",
  "protocol_version": "<string>",
  "authorization_secret_id": "<string>",
  "authorization": "<string>"
}
'

{
  "object": "mcp_server",
  "id": "<string>",
  "name": "<string>",
  "icon_url": "<string>",
  "base_url": "<string>",
  "transport": "<string>",
  "protocol_version": "<string>",
  "authorization_secret_id": "<string>",
  "status": "<string>",
  "metadata": {
    "requires_oauth": true,
    "oauth_configured": true,
    "tool_count": 123,
    "last_synced_at": "<string>"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "managed_by_app": {
    "app_uuid": "<string>",
    "app_name": "<string>"
  }
}

{
  "status_code": 123,
  "error": "rate_limit_exceeded",
  "message": "<string>",
  "retryable": true,
  "statusCode": 123,
  "mitigation": "<string>",
  "details": {
    "reason": "<string>"
  }
}

PATCH

organization

mcp-servers

{server_id}

Update MCP server

import requests

url = "https://api.datagrid.com/v1/organization/mcp-servers/{server_id}"

payload = {
    "name": "<string>",
    "base_url": "<string>",
    "transport": "http",
    "icon_url": "<string>",
    "protocol_version": "<string>",
    "authorization_secret_id": "<string>",
    "authorization": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    base_url: '<string>',
    transport: 'http',
    icon_url: '<string>',
    protocol_version: '<string>',
    authorization_secret_id: '<string>',
    authorization: '<string>'
  })
};

fetch('https://api.datagrid.com/v1/organization/mcp-servers/{server_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request PATCH \
  --url https://api.datagrid.com/v1/organization/mcp-servers/{server_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "base_url": "<string>",
  "transport": "http",
  "icon_url": "<string>",
  "protocol_version": "<string>",
  "authorization_secret_id": "<string>",
  "authorization": "<string>"
}
'

{
  "object": "mcp_server",
  "id": "<string>",
  "name": "<string>",
  "icon_url": "<string>",
  "base_url": "<string>",
  "transport": "<string>",
  "protocol_version": "<string>",
  "authorization_secret_id": "<string>",
  "status": "<string>",
  "metadata": {
    "requires_oauth": true,
    "oauth_configured": true,
    "tool_count": 123,
    "last_synced_at": "<string>"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "managed_by_app": {
    "app_uuid": "<string>",
    "app_name": "<string>"
  }
}

{
  "status_code": 123,
  "error": "rate_limit_exceeded",
  "message": "<string>",
  "retryable": true,
  "statusCode": 123,
  "mitigation": "<string>",
  "details": {
    "reason": "<string>"
  }
}

Updates a registered MCP server. Common uses:

rotate endpoint URL (base_url)
change display name
set or clear server-level authorization (authorization or authorization_secret_id)

Datagrid automatically attempts a tool re-sync when MCP connectivity/auth fields are updated. If both authorization and authorization_secret_id are sent, authorization takes precedence. Ownership note:

authorization creates or rotates a Datagrid-managed secret for this MCP server.
authorization_secret_id switches the server to an existing caller-managed secret reference.
Clearing auth removes the MCP server’s reference. Datagrid only auto-deletes secrets that it created from authorization.

curl -X PATCH https://api.datagrid.com/v1/organization/mcp-servers/SERVER_ID \
  -H "Authorization: Bearer $DATAGRID_API_KEY" \
  -H "Datagrid-Teamspace: $DATAGRID_TEAMSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "authorization": "Bearer rotated-token"
  }'

server = client.organization.mcp_servers.update(
    "SERVER_ID",
    authorization="Bearer rotated-token",
)

const server = await client.organization.mcpServers.update("SERVER_ID", {
  authorization: "Bearer rotated-token",
});

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

server_id

string

required

The ID of the MCP server.

Body

application/json

name

string

Maximum string length: 255

base_url

string<uri>

The HTTPS URL of the MCP server.

transport

enum<string> | null

Available options:

http

Maximum string length: 64

icon_url

string | null

Maximum string length: 1024

protocol_version

string | null

Maximum string length: 32

authorization_secret_id

string | null

Secret ID containing the full Authorization header value to use when calling this MCP server. Set to null to clear.

authorization

string | null

Raw Authorization header value (for example, 'Bearer '). Datagrid stores it as a secret and links it to this server. Set to null to clear. If both authorization and authorization_secret_id are provided, authorization takes precedence.

Maximum string length: 64000

Response

Updated MCP server

object

enum<string>

required

Available options:

mcp_server

string

required

name

string

required

icon_url

string | null

required

base_url

string<uri>

required

transport

string

required

protocol_version

string | null

required

authorization_secret_id

string | null

required

Secret ID containing the full Authorization header value used for this registered MCP server.

status

string

required

metadata

object | null

required

Safe subset of server metadata exposed to API consumers.

Show child attributes

created_at

string<date-time>

required

updated_at

string<date-time>

required

managed_by_app

object

Present when the MCP server is provisioned and managed by an installed app. Managed servers are read-only through this API.

Show child attributes

Introduction

Converse

Voice

Identity

Agents

Skills

Automations

Knowledge

Search

Conversations

Messages

Connections

Connection Providers

Connectors

Files

Tools

Secrets

Webhooks

Memory

Pages

MCP Servers - Beta

Batch Predictions

Event Triggers

Channels

Organization

Update MCP server

Authorizations

Path Parameters

Body

Response