---
title: "Get Tool"
method: GET
path: "/sdk/v1/tools/{id}"
---

# Get Tool

`GET /sdk/v1/tools/{id}`

Fetch the details of a specific tool using its ID.

## Path parameters

- `id` string, required

## Response `200`

Successfully retrieved the tool configuration

- Tool
  - `id` string, required — The initial messages to be included with your call to the LLM API.
  - `name` string, required — The name of the tool to be called. Must be a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64.
  - `description` string, required — A description of what the tool does, used by the model to choose when and how to call the tool.
  - `parameters` ToolParameters, required — The parameters the functions accepts, described as a JSON Schema object. This schema is designed to match the TypeScript Record<string, unknown>, allowing for any properties with values of any type.

## Other responses

- `400` — Missing or invalid parameters
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/prompt-foundry/apis/prompt-foundry-api.md) · [All operations](https://skmtc.net/prompt-foundry/apis/prompt-foundry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prompt-foundry/prompt-foundry-api/versions/84eb1e848fd1/schema)