Skip to main content
GET
JavaScript
Every tool in one tool set: its parameters, its state, and the name Cadenya hands the model.

llmToolName is the name the agent calls

metadata.name is the tool’s name from its source. spec.llmToolName is the cleaned-up version Cadenya derives for the model: issue_refund becomes IssueRefund. When you match a toolCalled event back to a tool, or debug why a model called something, llmToolName is the string the model saw.

Four filters, four behaviors

They differ, so pick by intent.
query is a case-insensitive contains, which is looser than the name prefix filter on List tool sets. names is the exact-match escape hatch: it is the one filter unaffected by the space defect in prefix and query, so reach for it when you know the tool name.

Filter state with states, not state

The parameter is plural and repeatable. A singular state=... is ignored and returns everything.
STATE_AVAILABLE is callable; STATE_OMITTED is hidden by omit or a filter but still in the set. An omitted tool shows here, with its state, so this is how you audit what an agent cannot see.

List tool sets

The sets these tools belong to, with counts.

Omit a tool

Why a tool reads STATE_OMITTED here.

Create a tool set

Where llmToolName and parameters are set.

Get a tool

One tool, by ID.

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"

toolSetId
string
required

Tool set ID. Accepts the canonical ts_… form or the external_id: form.

Example:

"toolset_01HXKD2E5NQM3T9AYWCFNRMN74"

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

names
string[]

Filter by tool name (exact match). Multiple values are OR'd together.

states
enum<string>[]

Filter by tool state. Multiple values are OR'd together.

Available options:
STATE_UNSPECIFIED,
STATE_AVAILABLE,
STATE_OMITTED,
STATE_ARCHIVED
requiresApproval
boolean

Filter by approval requirement. Omitted = no filter; true = only tools requiring approval; false = only tools not requiring approval.

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.