Tools

Get a tool by ID

Returns a single tool in the unified Tool shape, whatever its type. The contract the model sees (name, description, inputs, outputs) and the controls that gate it (enabled, direct_use, availability_rules) sit at the top level; everything specific to how the tool runs is nested under the key matching type.

Authorization headers are stripped from api.request.headers; other header values pass through with variable references translated to the {var:<name>|<default>} form.

get/v2/tools/{tool_id}

Request

  • Base URL: https://example.ada.support/api
  • URL: https://example.ada.support/api/v2/tools/{tool_id}
  • Auth: HTTP bearer

Path parameters

tool_idstring id required

The tool's id

Response

The tool

idstring required

The tool's id

type'api' | 'code' required

Which kind of tool this is, and which implementation key is present

namestring required

The tool's name, as the model sees it

descriptionstring required

What the tool does, as the model sees it

enabledboolean required

Whether the tool is available to the Agent at all

direct_useboolean nullable required

Whether the Agent may call this tool on its own, rather than only as a step inside a process.

Changes

No recorded changes to this operation across all 1 revision of this API.