---
title: "List tools"
method: GET
path: "/api/v1/tools"
tags: ["Tool Calling"]
---

# List tools

`GET /api/v1/tools`

Workspace catalog. Fetch tools by provider, identifier, and connector. Use this when you need every tool in the environment, not tools bound to one user. If `filter.summary` is true, returns only tool names.

## Query parameters

- `filter.summary` boolean
- `filter.provider` string
- `filter.identifier` string
- `filter.tool_name` string[]
- `filter.query` string
- `filter.connector` string
- `filter.organization_id` string
- `filter.user_id` string
- `filter.connected_account_id` string
- `page_size` integer
- `page_token` string

## Response `200`

Paginated list of tools matching the filter

- ToolsListToolsResponse
  - `next_page_token` string — Token for fetching the next page of tools
  - `prev_page_token` string — Token for fetching the previous page of tools
  - `tool_names` string[] — List of tool names, returned when filter.summary is true
  - `tools` ToolsTool[] — List of tools, returned when filter.summary is false or omitted
    - `definition` object — Tool definition in structured format
    - `id` string — Unique ID of the tool. Immutable and read-only.
    - `is_default` boolean — Marks this tool as the default version for the combination. Read-only.
    - `metadata` object — Additional metadata about the tool
    - `provider` string — Provider name (e.g. GOOGLE). Read-only.
    - `tags` string[] — Tags for categorization or filtering
    - `updated_at` string, date-time — Timestamp when the tool was last updated. Read-only.
  - `total_size` integer — Total number of tools matching the query

## Other responses

- `400` — Invalid request - malformed filter or pagination parameters
- `401` — Authentication required - missing or invalid access token

---

[API](https://skmtc.net/scalekit/apis/scalekit-api-reference.md) · [All operations](https://skmtc.net/scalekit/apis/scalekit-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalekit/scalekit-api-reference/revisions/a7181708713b/schema)