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

# POST /v1/{+parent}:retrieveToolSchema

`POST /v1/{+parent}:retrieveToolSchema`

Retrieve the schema of the given tool. The schema is computed on the fly for the given instance of the tool.

## Path parameters

- `parent` string, required

## Request body

- RetrieveToolSchemaRequest — Request message for ToolService.RetrieveToolSchema.
  - `tool` string — Optional. The name of the tool to retrieve the schema for. Format: projects/{project}/locations/{location}/apps/{app}/tools/{tool}
  - `toolsetTool` ToolsetTool — A tool that is created from a toolset.
    - `toolset` string — Required. The resource name of the Toolset from which this tool is derived. Format: `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}`
    - `toolId` string — Optional. The tool ID to filter the tools to retrieve the schema for.

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