Skip to main content
PATCH
Update a tool kit

Authorizations

X-Api-Key
string
header
required

Personal or workspace LangSmith API key. Personal keys identify the user. Workspace keys are limited to server listing and MCP calls and must also supply the end user's OIDC token or X-LangSmith-Identity.

X-Tenant-Id
string
header
required

Workspace UUID. This header selects a workspace; it does not authenticate the caller.

Path Parameters

kit_id
string<uuid>
required

Tool kit ID

Body

application/json

Changes to a tool kit. Omitted fields are unchanged.

connection_policy
enum<string>

ALLOW_PARTIAL, the only supported policy, lists the kit's tools, including those of servers the caller has not connected when their definitions are known; calling one asks the caller to connect it.

Available options:
ALLOW_PARTIAL
description
string | null

New description, up to 4096 characters. Null clears it.

Maximum string length: 4096
name
string

New tool kit name, up to 256 characters.

Maximum string length: 256
Example:

"Support agent"

tools
object[]

Replacement tool selection. Null or an empty array removes all tools.

Maximum array length: 10000

Response

OK

A tool kit: selected tools from one or more servers, exposed through one MCP endpoint.

connection_policy
enum<string>

ALLOW_PARTIAL lists the kit's tools, including those of servers the caller has not connected when their definitions are known; calling one asks the caller to connect it.

Available options:
ALLOW_PARTIAL
created_at
string

When the tool kit was created.

created_by
string<uuid> | null

LangSmith user who created the tool kit.

description
string

What the tool kit is for.

id
string<uuid>

Tool kit ID.

mcp_path
string

Streamable HTTP endpoint for this tool kit.

name
string

Tool kit name.

Example:

"Support agent"

scope
enum<string>

Who can see the tool kit: the whole workspace, or only its owner.

Available options:
personal,
workspace
server_count
integer

Number of MCP servers and built-ins the selected tools come from.

tool_count
integer

Number of selected tools.

tools
object[]

Selected tools. Omitted from list responses.

updated_at
string

When the tool kit last changed.

updated_by
string<uuid> | null

LangSmith user who last changed the tool kit.