Sign in

v3

latestOpenAPI 3.0.02026-08-081996601.2 MB
Tools

Update tool

Updates an existing tool’s configuration, including its metadata, enabled status, or other properties. Updating a tool changes how agents invoke it during a session.

patch/v2/tools/{tool_id}

Path parameters

tool_idstring required
Example:tol_rag_search

The unique identifier of the tool to update.

Headers

Request-Timeoutinteger

The platform makes a best effort to complete the request in the specified seconds, or it times out.

Request-Timeout-Millisinteger

The platform makes a best effort to complete the request in the specified milliseconds, or it times out.

Request body

OR
OR

Example request

{
  "type": "mcp"
}

Response

The tool is updated.

OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR

Example response

{
  "id": "tol_123e4567-e89b-12d3-a456-426614174000",
  "default_output_transform": ".results | map({title, url})",
  "default_input_transform": ".args + { auth: (\"Bearer \" + .agent.secrets.token) }",
  "default_argument_override": {
    "max_results": 10
  },
  "lineage": "corpora_search",
  "version": "2026-02-23",
  "tool_groups": [
    "document_ingestion"
  ],
  "type": "dynamic_vectara"
}