Toggle connector tool

PUT https://app.sulus.ai/api/v1/agents/{agent_id}/connectors/{connector_id}/tools

Switch one tool of an enabled connector on or off

Authentication

Send a bearer token created on your dashboard's Developer page:

Authorization: Bearer <YOUR_API_KEY>

Path parameters

agent_id string Required

The agent id (UUID).

Validation: uuid (route-constrained)

Stored in ai_projects.uid

connector_id string Required

The connector uid from the list response.

Validation: uuid (route-constrained)

Stored in ai_mcp_connectors.uid

Request body

tool string Required

The tool name as returned in the connector's tools list.

Validation: required|string|max:255

Stored in ai_project_mcp_connectors.disabled_tools

enabled boolean Required

Desired state. A disabled tool is never offered to the model.

Validation: required|boolean

Stored in ai_project_mcp_connectors.disabled_tools

Errors

Status	Meaning	Body
`404`	Agent not found, or you do not have access to it
`404`	Connector not found or not available to you
`403`	You do not have MCP access to this agent.	`{"message":"You do not have MCP access to this agent."}`
`422`	Validation failed	`{"message":"…","errors":{"field":["…"]}}`
`401`	Missing or invalid bearer token
`403`	Feature ai_chat not enabled for the account

Notes

Requires connector permission on the agent (independent of write access).

curl --request PUT \
  --url https://app.sulus.ai/api/v1/agents/{agent_id}/connectors/{connector_id}/tools \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{"tool": "search-docs", "enabled": false}'

import requests

url = "https://app.sulus.ai/api/v1/agents/{agent_id}/connectors/{connector_id}/tools"
headers = {"Authorization": "Bearer <YOUR_API_KEY>"}
payload = {"tool": "search-docs", "enabled": false}

response = requests.put(url, json=payload, headers=headers)
print(response.json())

package main

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

func main() {
	url := "https://app.sulus.ai/api/v1/agents/{agent_id}/connectors/{connector_id}/tools"
	payload := strings.NewReader(`{"tool": "search-docs", "enabled": false}`)
	req, _ := http.NewRequest("PUT", url, payload)
	req.Header.Add("Authorization", "Bearer <YOUR_API_KEY>")
	req.Header.Add("Content-Type", "application/json")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

Response 200

{
    "message": "Tool \"search-docs\" disabled.",
    "data": {
        "tool": "search-docs",
        "enabled": false
    }
}

{
    "message": "Tool \"search-docs\" disabled.",
    "data": {
        "tool": "search-docs",
        "enabled": false
    }
}