Toggle a tool

Sets whether a tool is enabled. The parent service can still disable the tool at runtime even if the stored tool flag is true.

POST /services/{serviceName}/tools/{toolName}/enabled

Toggle a tool

cURL

curl --request POST \
  --url http://localhost:7687/services/{serviceName}/tools/{toolName}/enabled \
  --header 'Content-Type: application/json' \
  --data '
{
  "enabled": true
}
'

200

{
  "name": "<string>",
  "serviceName": "<string>",
  "enabled": true
}

Path Parameters

serviceName · string · required

Normalized service name.

Minimum string length: 1

toolName · string · required

Tool name within the service manifest.

Minimum string length: 1

Body

application/json

Request body used to enable or disable a tool.

enabled · boolean · required

Desired enabled state for the tool.

Response

200

application/json

Updated tool enabled state.

Response returned after toggling a tool enabled state.

name · string · required

Tool name whose enabled state was updated.

Minimum string length: 1

serviceName · string · required

Owning service name for the tool.

Minimum string length: 1

enabled · boolean · required

The new enabled state stored for the tool.