---
title: "List tool sets"
method: GET
path: "/v1/workspaces/{workspaceId}/tool_sets"
tags: ["ToolService", "Tool Sets"]
---

# List tool sets

`GET /v1/workspaces/{workspaceId}/tool_sets`

Lists all tool sets in the workspace

## Path parameters

- `workspaceId` string, required

## Query parameters

- `limit` integer
- `cursor` string
- `prefix` string
- `query` string
- `bundleKey` string
- `state` 'STATE_UNSPECIFIED' | 'STATE_ACTIVE' | 'STATE_ARCHIVED', enum
- `sortOrder` string
- `includeInfo` boolean

## Response `200`

OK

- ListToolSetsResponse
  - `items` ToolSet[]
    - `metadata` ResourceMetadata, required — Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
      - `id` string, required — Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...")
      - `accountId` string, required — Account this resource belongs to for multi-tenant isolation (prefixed ULID)
      - `workspaceId` string, required — Workspace this resource belongs to for organizational grouping (prefixed ULID)
      - `name` string, required — Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly
      - `externalId` string — External ID for the resource (e.g., a workflow ID from an external system)
      - `labels` object — Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"}
      - `profileId` string, required — ID of the actor (user or service account) that created this resource
      - `createdAt` string, date-time, required — Timestamp when this resource was created
      - `bundleKey` string — Optional bundle ownership key. When set, indicates the resource is managed by a configuration bundle identified by this key. Used by BulkWorkspaceResources.Apply to track which resources belong to which bundle for reconciliation / soft-delete on re-apply.
      - `updatedAt` string, date-time — Timestamp when this resource was last updated
    - `spec` ToolSetSpec, required
      - `description` string
      - `adapter` ToolSetAdapter
        - `mcp` ToolSetAdapterMCP
          - `url` string
          - `headers` object
          - `includeTools` ToolSetAdapterToolFilter — Top-level filter with simple boolean logic (no nesting)
            - `filters` ToolSetAdapterAttributeFilter[]
              - …
            - `operator` 'OPERATOR_UNSPECIFIED' | 'OPERATOR_AND' | 'OPERATOR_OR' | 'OPERATOR_AND' | 'OPERATOR_OR', enum, required
          - `excludeTools` ToolSetAdapterToolFilter — Top-level filter with simple boolean logic (no nesting)
            - `filters` ToolSetAdapterAttributeFilter[]
              - …
            - `operator` 'OPERATOR_UNSPECIFIED' | 'OPERATOR_AND' | 'OPERATOR_OR' | 'OPERATOR_AND' | 'OPERATOR_OR', enum, required
          - `toolApprovals` ToolSetAdapterApprovalRequirementFilter — Approval filters that will automatically set the approval requirement on tools synced from an external source
            - `always` boolean
            - `only` ToolSetAdapterToolFilter — Top-level filter with simple boolean logic (no nesting)
              - …
        - `http` ToolSetAdapterHTTP
          - `baseUrl` string
          - `headers` object
        - `openapi` ToolSetAdapterOpenAPI
          - `url` string — URL to fetch the OpenAPI spec from. Synced automatically every hour.
          - `uploadId` string — ID of a COMPLETE Upload containing the OpenAPI spec document.
          - `headers` object — Headers sent when fetching the spec from a URL and when dispatching tool calls.
          - `includeTools` ToolSetAdapterToolFilter — Top-level filter with simple boolean logic (no nesting)
            - `filters` ToolSetAdapterAttributeFilter[]
              - …
            - `operator` 'OPERATOR_UNSPECIFIED' | 'OPERATOR_AND' | 'OPERATOR_OR' | 'OPERATOR_AND' | 'OPERATOR_OR', enum, required
          - `excludeTools` ToolSetAdapterToolFilter — Top-level filter with simple boolean logic (no nesting)
            - `filters` ToolSetAdapterAttributeFilter[]
              - …
            - `operator` 'OPERATOR_UNSPECIFIED' | 'OPERATOR_AND' | 'OPERATOR_OR' | 'OPERATOR_AND' | 'OPERATOR_OR', enum, required
          - `toolApprovals` ToolSetAdapterApprovalRequirementFilter — Approval filters that will automatically set the approval requirement on tools synced from an external source
            - `always` boolean
            - `only` ToolSetAdapterToolFilter — Top-level filter with simple boolean logic (no nesting)
              - …
          - `baseUrl` string — Base URL for dispatching tool calls. If set, overrides the server resolved from the spec's servers array.
          - `serverName` string — Name of the server entry in the spec's servers array (OpenAPI 3.2 server.name field). Used to select which server URL to dispatch to when base_url is not set. If unset, the first server is used. Ignored when base_url is set.
    - `info` ToolSetInfo
      - `toolCount` integer
      - `agentCount` integer
      - `lastSync` string, date-time
      - `createdBy` Profile — A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces.
        - `metadata` AccountResourceMetadata, required — AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace.
          - `id` string, required — Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...")
          - `accountId` string, required — Account this resource belongs to for multi-tenant isolation (prefixed ULID)
          - `name` string, required — Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly
          - `externalId` string — External ID for the resource (e.g., a workflow ID from an external system)
          - `labels` object — Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"}
          - `profileId` string, required
        - `spec` ProfileSpec, required — Configuration for a profile.
          - `email` string — Email address of the profile. Required and unique within an account for user profiles.
          - `name` string — Display name (e.g., "Bobby Tables").
          - `type` 'PROFILE_TYPE_UNSPECIFIED' | 'PROFILE_TYPE_USER' | 'PROFILE_TYPE_API_KEY' | 'PROFILE_TYPE_SYSTEM', enum, required — Whether this profile represents a human user, an API key, or a system principal.
    - `state` 'STATE_UNSPECIFIED' | 'STATE_ACTIVE' | 'STATE_ARCHIVED', enum, required — The current lifecycle state of the tool set. Output only. Tool sets are created STATE_ACTIVE; use the :archive and :unarchive actions to transition between states.
  - `pagination` Page
    - `nextCursor` string
    - `total` integer

## Other responses

- `default` — Default error response

## Changes

- **2026-06-09** `13d98d37dd96` — 3 info
  - added the new optional `query` request parameter `state`
  - added the optional property `items/items/metadata/updatedAt` to the response with the `200` status
  - added the required property `items/items/state` to the response with the `200` status
- **2026-06-05** `0702cb021b66` — 1 warning
  - added the new `PROFILE_TYPE_UNSPECIFIED` enum value to the `items/items/info/allOf[#/components/schemas/ToolSetInfo]/createdBy/spec/type` response property for the response status `200`

[Change history](https://skmtc.dev/cadenya/apis/cadenya-api/changes/v1/workspaces/:workspaceId/tool_sets/get.md)

---

[API](https://skmtc.dev/cadenya/apis/cadenya-api.md) · [All operations](https://skmtc.dev/cadenya/apis/cadenya-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cadenya/apis/cadenya-api/revisions/ea07a25ab5da?raw)