ToolService
Tool Sets
List tool set usage
Lists the agent variations (with their parent agent) that have the tool set assigned. Pass tool_id to instead list variations with a direct assignment of that individual tool; variations that receive the tool implicitly through a whole-set assignment are not included in that filtered view.
get/v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/usage
Path parameters
workspaceIdstring required
Example:workspace_01HXKD2E5NQM3T9AYWCF133E3Q
Workspace ID.
toolSetIdstring required
Example:toolset_01HXKD2E5NQM3T9AYWCFNRMN74
Tool set ID. Accepts the canonical ts_… form or the external_id:<value> form.
Query parameters
toolIdstring
Example:tool_01HXKD2E5NQM3T9AYWCFWVYY9K
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.
limitinteger
Maximum number of results to return
cursorstring
Pagination cursor from previous response
sortOrderstring
Sort order for results (asc or desc by assignment creation time)
Response
OK
Example response
{
"items": [
{
"agentVariation": {
"accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
"workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
"profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
},
"agent": {
"accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
"workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
"profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
},
"model": {
"accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
"workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
"profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
}
}
]
}