Sign in
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"
}

Changes

Changed in 2 of the 7 revisions of this API.2226

  • 0d51a9e3a0b32See the full diff
    • ○

      request property ///// deprecated

      request-property-deprecated

    • ○

      response property oneOf[LambdaTool]/allOf[subschema #2]/function_definition/execution_configuration/max_memory_mb deprecated

      response-property-deprecated

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • fca567a46b3a2224See the full diff
    • ▲

      the //////// request property type changed from object to no type

      request-property-type-changed

    • ▲

      the //////// request property type changed from object to no type

      request-property-type-changed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ●

      removed the request property /////////

      request-property-removed

    • ○

      added discriminator to //////// request property

      request-property-discriminator-added

    • ○

      added discriminator to //////// request property

      request-property-discriminator-added

    • ○

      added to the //////// request property oneOf list

      request-property-one-of-added

    • ○

      added to the //////// request property oneOf list

      request-property-one-of-added