---
title: "Retrieve tool"
method: GET
path: "/v1/tools/{id}"
tags: ["Tool"]
---

# Retrieve tool

`GET /v1/tools/{id}`

Retrieves a tool.

## Path parameters

- `id` string, required

## Response `200`

OK

- Tool
  - `code` string, required
  - `description` string, required
  - `id` string, required
  - `input_schema` unknown, required
  - `language` 'python' | 'javascript' | 'typescript', required
  - `name` string, required
  - `revision_id` string, required

## Other responses

- `401` — Unauthenticated error response

## Changes

- **2025-01-15** `fbf471c508c8` — 3 warning, 3 info
  - added the new `javascript` enum value to the `language` response property for the response status `200`
  - added the new `python` enum value to the `language` response property for the response status `200`
  - added the new `typescript` enum value to the `language` response property for the response status `200`
  - removed the `JAVASCRIPT` enum value from the `language` response property for the response status `200`
  - …2 more
- **2024-12-05** `9a6cae8060b4` — 2 info
  - removed the `PHP` enum value from the `language` response property for the response status `200`
  - removed the `RUBY` enum value from the `language` response property for the response status `200`
- **2024-11-06** `6a6ef20cc3e9` — 2 info
  - api operation id `retrieveTool` was added
  - api tag `Tool` added
- **2024-11-06** `f91a367833f8` — 1 info
  - added the required property `language` to the response with the `200` status
- **2024-10-31** `333818f2f208` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/riza-io/apis/execute/changes/v1/tools/:id/get.md)

---

[API](https://skmtc.dev/riza-io/apis/execute.md) · [All operations](https://skmtc.dev/riza-io/apis/execute/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/riza-io/execute/revisions/fbf471c508c8/schema)