List tools

Lists all tools in the tool set

get/v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/tools

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

limitinteger

Maximum number of results to return

cursorstring

Pagination cursor from previous response

prefixstring

Filter expression (query param: prefix)

querystring

Free-form search query

namesstring[]

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

statesstring[]

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

requiresApprovalboolean

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

labelsstring

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

sortOrderstring

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

includeInfoboolean

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

Response

Example response

{
  "items": [
    {
      "metadata": {
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
      },
      "info": {
        "toolSet": {
          "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
          "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
          "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
        },
        "createdBy": {
          "metadata": {
            "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
            "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
          }
        }
      }
    }
  ]
}

Changes

Changed in 9 of the 57 revisions of this API.41313

Jul 19, 20263ecc1debabfa241See the full diff
- ▲
  added ToolSpec_Config_Http ToolSpec_Config_Mcp ToolSpec_Config_Openapi ToolSpec_Config_Bare to the items/items/spec/config/allOf[ToolSpec_Config]/ response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  the items/items/spec/config/allOf[ToolSpec_Config]/ response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ●
  removed the optional property items/items/spec/config/allOf[ToolSpec_Config]/bare from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/items/spec/config/allOf[ToolSpec_Config]/http from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/items/spec/config/allOf[ToolSpec_Config]/mcp from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/items/spec/config/allOf[ToolSpec_Config]/openapi from the response with the 200 status
  response-optional-property-removed
- ○
  added discriminator to items/items/spec/config/allOf[ToolSpec_Config]/ response property for the response status 200
  response-property-discriminator-added
Jul 8, 2026a99a473ee3ad1See the full diff
- ●
  removed the optional property pagination/total from the response with the 200 status
  response-optional-property-removed
Jul 8, 2026e72f368ddab71See the full diff
- ○
  added the new optional query request parameter labels
  new-optional-request-parameter
Jul 6, 2026ca78d3d0b7c21See the full diff
- ○
  added the optional property items/items/spec/config/allOf[ToolSpec_Config]/bare to the response with the 200 status
  response-optional-property-added
Jul 3, 202602498bf606f01See the full diff
- ○
  added the optional property items/items/info/signature to the response with the 200 status
  response-optional-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 2, 20262cf447ae9ee91See the full diff
- ○
  added the optional property items/items/spec/config/allOf[ToolSpec_Config]/mcp/annotations to the response with the 200 status
  response-optional-property-added
Jul 2, 202606e0e37c1499163See the full diff
- ▲
  the items/items/spec/config response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ●
  deleted the query request parameter bundleKey
  request-parameter-removed
- ●
  removed the optional property items/items/info/toolSet/bundleKey from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/items/metadata/bundleKey from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/items/spec/config/http from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/items/spec/config/mcp from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/items/spec/config/openapi from the response with the 200 status
  response-optional-property-removed
- ○
  added the optional property items/items/info/createdBy/metadata/createdAt to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/items/spec/llmToolName to the response with the 200 status
  response-optional-property-added
- ○
  added ToolSpec_Config to the items/items/spec/config response property allOf list for the response status 200
  response-property-all-of-added
This revision also has 27 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 9, 202613d98d37dd96115See the full diff
- ▲
  removed the required property items/items/spec/status from the response with the 200 status
  response-required-property-removed
- ●
  deleted the query request parameter statuses
  request-parameter-removed
- ○
  added the new optional query request parameter states
  new-optional-request-parameter
- ○
  added the optional property items/items/info/toolSet/updatedAt to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/items/metadata/updatedAt to the response with the 200 status
  response-optional-property-added
- ○
  the response property items/items/spec/requiresApproval became required for the status 200
  response-property-became-required
- ○
  added the required property items/items/state to the response with the 200 status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 5, 20260702cb021b661See the full diff
- ●
  added the new PROFILE_TYPE_UNSPECIFIED enum value to the items/items/info/createdBy/spec/type response property for the response status 200
  response-property-enum-value-added

Full history