Sign in
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"
      }
    }
  ]
}

Changes

Changed in 1 of the 57 revisions of this API.1