Skip to main content
PATCH
/
v1
/
agents
/
{id}
/
tools
Toggle a tool for an agent
curl --request PATCH \
  --url https://api.conduit.ai/v1/agents/{id}/tools \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tool_name": "lookup-order-status",
  "source": "custom",
  "enabled": true
}
'
{
  "data": {
    "id": "kg77c0dy0mgdpzmqz6tesry8w184002s",
    "name": "lookup-order-status",
    "source": "custom",
    "description": "Look up the fulfillment status of an order by id.",
    "enabled": true,
    "domain": null,
    "tags": [],
    "language": "python"
  }
}

Authorizations

​
Authorization
string
header
required

Conduit API token. Use Authorization: Bearer <token>. Read/write endpoints require a token with write access.

Path Parameters

​
id
string
required

V2 chat agent id.

Example:

"ag77c0dy0mgdpzmqz6tesry8w184002s"

Query Parameters

​
workspace_id
string

Optional workspace override. If omitted, Conduit resolves the agent's workspace automatically.

Example:

"j57demo8f8x7c9v0n2q4r6t8y1u3i5o"

Body

application/json

Enable or disable a single tool for a V2 chat agent. The (tool_name, source) pair identifies the tool.

​
tool_name
string
required

Name of the tool to toggle, as returned by GET /v1/agents/{id}/tools.

Minimum string length: 1
​
source
enum<string>
required

builtin for a platform tool from the tools catalog, custom for a workspace custom code tool.

Available options:
builtin,
custom
​
enabled
boolean
required

Set true to enable the tool for this agent, false to disable.

Response

Updated tool access

The tool's resolved access state after the change.

​
data
object
required