dots.v2.actionGateway.mcpServers.byServer_ref().tools.put()
Generated on 13 Nov 2026
from DoTs version
v1.24.0
Usage
client.v2.actionGateway.mcpServers.byServer_ref(server_ref).tools.put(body: Mcp_server_tools_update, requestConfiguration?: RequestConfiguration<object>): Promise<undefined | List_mcp_server_tools_response>Description
enabledToolSlugs is the complete set to enable; every other tool of the server is disabled. An
enabled tool is added to your team’s catalog at its latest discovered version, and a disabled one is
removed from it. Repeating the same set changes nothing.
Before changing anything, each tool being enabled, re-enabled, or moved to a newer discovered version is verified against the live server: it must still be listed there, with the same input schema as when it was discovered. If any check fails or the server cannot be reached, the request fails with 400 and nothing changes; resync and try again. An unknown tool slug is also rejected with 400. A request that needs verification counts against the resync rate limit (429). Returns the server’s full tool list.
Parameters
Path Parameters
server_refstring requiredExample:
docsServer identifier (
serverRef) of one of your team's MCP servers.
Request Body
enabledToolSlugsarray of strings requiredExample:
["docs_search", "docs_get_page"]The complete set of tool slugs (
<server_ref>_<name>) to enable; every other tool of the server is disabled. Empty disables every tool.userIdstring optionalRequired for a server registered with
credentialRefSourceconnection when a tool needs verification against the live server, which can only be reached as a user who has authorized it. Ignored otherwise.
Request Sample
Response Example
More Information
See /v2/action-gateway/mcp-servers/{server_ref}/tools in the API reference for additional detail on responses, headers, parameters, and more.