List tool sets
Every tool set in a workspace, with a live tool count. Archived ones stay hidden unless you ask.
state, the adapter in spec, and an info block with the counts you usually want.
The default list hides archived sets
OnlySTATE_ACTIVE tool sets come back by default. An archived set is out of the way until you ask for it by state:
info needs no opt-in
includeInfo is a no-op here. Every list row carries info, whether you pass it or not:
availableTools plus omittedTools accounts for every tool. agentCount is meant to be the count of variations assigning the set, but it currently always reads 0, so do not rely on it to tell whether a set is in use.
Filtering
state, prefix, query, and labels all narrow the list. prefix and query match the name, folding case on query:
sortOrder sorts by creation, and limit sets a page size the SDK iterator pages past on its own.
What a row tells you
syncCompleted.
Related
Create a tool set
List tools
Search tools and tool sets
Archive a tool set
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Workspace ID.
"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"
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 set lifecycle state. Defaults to STATE_ACTIVE when unspecified; pass STATE_ARCHIVED to list archived tool sets.
STATE_UNSPECIFIED, STATE_ACTIVE, STATE_ARCHIVED 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