---
title: "POST /v1/{+toolset}:retrieveTools"
method: POST
path: "/v1/{+toolset}:retrieveTools"
tags: ["projects"]
---

# POST /v1/{+toolset}:retrieveTools

`POST /v1/{+toolset}:retrieveTools`

Retrieve the list of tools included in the specified toolset.

## Path parameters

- `toolset` string, required

## Request body

- RetrieveToolsRequest — Request message for ToolService.RetrieveTools.
  - `bypassPersistenceConfig` boolean — Optional. If true, the returned tools will contain raw descriptions and schemas directly from the server, bypassing any stored persistence configurations (overrides/snapshots).
  - `toolIds` string[] — Optional. The identifiers of the tools to retrieve from the toolset. If empty, all tools in the toolset will be returned.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/ces.md) · [All operations](https://skmtc.net/google/apis/ces/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/ces/versions/429598666166/schema)