List tool set usage
The agent variations that use a tool set. Answers “what breaks if I delete this?” before you find out.
Filter down to one tool
PasstoolId to list only the variations with a direct assignment of that individual tool. The tool must belong to the set. Variations that receive the tool implicitly, through a whole-set assignment, do not appear in the filtered view. So the two reads answer different questions: no filter answers “who uses this set”, and the filter answers “who asked for this specific tool by name”.
What a row carries
EachToolSetUsage row holds three metadata blocks (agentVariation, agent, model) and assignedAt, the moment the assignment was created. sortOrder sorts by that timestamp, and limit and cursor page the results the usual way.
Related
Delete a tool set
Add an assignment
List tool sets
Prevent tool bloat
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
When set, lists only variations with a direct assignment of this individual tool. When unset, lists variations assigned the whole tool set. The tool must belong to the tool set.
"tool_01HXKD2E5NQM3T9AYWCFWVYY9K"
Maximum number of results to return
Pagination cursor from previous response
Sort order for results (asc or desc by assignment creation time)