Skip to main content
GET
JavaScript
The capabilities available in a workspace. Each row carries a state, the adapter in spec, and an info block with the counts you usually want.

The default list hides archived sets

Only STATE_ACTIVE tool sets come back by default. An archived set is out of the way until you ask for it by state:
That is the clean way to audit what was retired without cluttering the working list.

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:
prefix and query match a single word. A query with a space returns nothing: ?query=Faker MCP is 0, even though that is the exact name. Search on one token.
sortOrder sorts by creation, and limit sets a page size the SDK iterator pages past on its own.

What a row tells you

To read the tools themselves, or watch a sync land, go to the set: List tools for its tools, List tool set events for syncCompleted.

Create a tool set

The four adapter kinds, and what each syncs.

List tools

The tools inside one set, with their states.

Search tools and tool sets

Find one to assign, across sets and agents.

Archive a tool set

Why a set hidden from this list is not deleted.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspaceId
string
required

Workspace ID.

Example:

"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"

Query Parameters

limit
integer<int32>

Maximum number of results to return

cursor
string

Pagination cursor from previous response

prefix
string

Filter expression (query param: prefix)

query
string

Free-form search query

state
enum<string>

Filter by tool set lifecycle state. Defaults to STATE_ACTIVE when unspecified; pass STATE_ARCHIVED to list archived tool sets.

Available options:
STATE_UNSPECIFIED,
STATE_ACTIVE,
STATE_ARCHIVED
labels
string

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).

sortOrder
string

Sort order for results (asc or desc by creation time)

includeInfo
boolean

When set to true you may use more of your alloted API rate-limit

Response

OK

items
object[]
pagination
object

Page carries cursor-based pagination state. There is no total: the cursor walks the result set without ever counting it, and a count would cost a second query on every list.