A2A Protocol15

Agent Aliases20

Agent Analytics4

Agent Connectors5

Agent End User Sessions6

Agent Identity2

Agent Schedules6

Agent Secrets3

Agent Sessions15

Agents6

API Keys5

Application Clients5

Authentication1

Chats9

Corpora9

CustomerMetrics2

Documents7

Encoders2

Factual Consistency Evaluation1

Generation Presets4

Glossaries8

Hallucination Correctors2

Index3

Instructions7

Jobs2

Large Language Models6

LLM Chat Completions1

Metadata Query1

Pipeline Dead Letters5

Pipeline Runs4

Pipelines7

Queries3

Query History2

Rerankers1

Table Extractors1

Tool Servers6

Tools7

Trusted Token Issuers5

Upload1

Users6

Widgets1

Tools

List tools

Lists all tools available to the authenticated user. Supports filtering and pagination. Tools represent capabilities that agents can invoke during a session, including built-in system tools and user-defined Lambda tools. Use filters to locate tools by name, type, status, or tool server.

get/v2/tools

Query parameters

filterstring

Example:rag.*

A regular expression against tool names and descriptions to filter the results.

type'mcp' | 'vectara' | 'lambda' | 'client'

Example:mcp

Return only tools in this category. Categories group tools by how they execute and are coarser than the type field on the returned tools: vectara matches the built-in Vectara tools, mcp tools provided by a tool server, lambda user-defined Python tools, and client tools executed by the calling client.

enabledboolean

Example:true

Filter tools by enabled status.

categorystring[]

Filter tools by category. Pass one or more category values to include only those categories. When omitted, the response excludes tools in the "experimental" category by default. To include experimental tools, explicitly pass category=experimental.

[
  "retrieval",
  "utilities"
]

tool_server_idstring

Example:tsr_rag_search

Filter tools by the tool server they belong to.

limitinteger

The maximum number of tools to return in the list.

page_keystring

The opaque cursor returned in metadata.page_key of the previous response. Omit it to fetch the first page.

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.

Response

List of available tools.

Example response

{
  "tools": [
    {
      "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"
    }
  ],
  "metadata": {
    "page_key": "eyJvZmZzZXQiOjF9"
  }
}

Changes

Changed in 3 of the 8 revisions of this API.152

Sep 4, 202605ae305c8d8415See the full diff
- ▲
  the ///////// response property's max was increased from 300.00 to 21600.00 for the response status
  response-property-max-increased
- ▲
  the ///////////////// response property's max was increased from 3600.00 to 21600.00 for the response status
  response-property-max-increased
- ▲
  the ///////////////// response property's max was increased from 3600.00 to 21600.00 for the response status
  response-property-max-increased
- ▲
  the ///////////////// response property's max was increased from 3600.00 to 21600.00 for the response status
  response-property-max-increased
- ▲
  the ///////////////// response property's max was increased from 3600.00 to 21600.00 for the response status
  response-property-max-increased
- ▲
  the ///////////////// response property's max was increased from 3600.00 to 21600.00 for the response status
  response-property-max-increased
- ▲
  the ///////////////// response property's max was increased from 3600.00 to 21600.00 for the response status
  response-property-max-increased
- ▲
  the ///////////////// response property's max was increased from 3600.00 to 21600.00 for the response status
  response-property-max-increased
- ▲
  the ///////////////// response property's max was increased from 3600.00 to 21600.00 for the response status
  response-property-max-increased
- ▲
  the ///////////////// response property's max was increased from 3600.00 to 21600.00 for the response status
  response-property-max-increased
- ▲
  the ///////////////// response property's max was increased from 3600.00 to 21600.00 for the response status
  response-property-max-increased
- ▲
  the ///////////////// response property's max was increased from 3600.00 to 21600.00 for the response status
  response-property-max-increased
- ▲
  the ///////////////// response property's max was increased from 3600.00 to 21600.00 for the response status
  response-property-max-increased
- ▲
  the ///////////////// response property's max was increased from 3600.00 to 21600.00 for the response status
  response-property-max-increased
- ▲
  the ////////////// response property's max was increased from 3600.00 to 21600.00 for the response status
  response-property-max-increased
This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 28, 2026abd45fb0c9741See the full diff
- ○
  added the new enum value vectara to the query request parameter type
  request-parameter-enum-value-added
Aug 27, 20260d51a9e3a0b31See the full diff
- ○
  response property tools/items/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

Full history