List tools
The tools inside one tool set, with the name the model sees and four ways to filter.
llmToolName is the name the agent calls
metadata.name is the tool’s name from its source. spec.llmToolName is the cleaned-up version Cadenya derives for the model: issue_refund becomes IssueRefund. When you match a toolCalled event back to a tool, or debug why a model called something, llmToolName is the string the model saw.
Four filters, four behaviors
They differ, so pick by intent.query is a case-insensitive contains, which is looser than the name prefix filter on List tool sets. names is the exact-match escape hatch: it is the one filter unaffected by the space defect in prefix and query, so reach for it when you know the tool name.
Filter state with states, not state
The parameter is plural and repeatable. A singular state=... is ignored and returns everything.
STATE_AVAILABLE is callable; STATE_OMITTED is hidden by omit or a filter but still in the set. An omitted tool shows here, with its state, so this is how you audit what an agent cannot see.
Related
List tool sets
Omit a tool
STATE_OMITTED here.Create a tool set
llmToolName and parameters are set.Get a tool
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Workspace ID.
"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"
Tool set ID. Accepts the canonical ts_… form or the external_id: form.
"toolset_01HXKD2E5NQM3T9AYWCFNRMN74"
Query Parameters
Maximum number of results to return
Pagination cursor from previous response
Filter expression (query param: prefix)
Free-form search query
Filter by tool name (exact match). Multiple values are OR'd together.
Filter by tool state. Multiple values are OR'd together.
STATE_UNSPECIFIED, STATE_AVAILABLE, STATE_OMITTED, STATE_ARCHIVED Filter by approval requirement. Omitted = no filter; true = only tools requiring approval; false = only tools not requiring approval.
Filters by metadata labels. Comma-separated key=value pairs, e.g. "env=prod,team=ai". A resource matches only if every pair matches exactly (AND semantics).
Sort order for results (asc or desc by creation time)
When set to true you may use more of your alloted API rate-limit