---
title: "Get Latest Tool Interface"
method: GET
path: "/v1beta2/tool/{tool_uid}/latest-interface"
tags: ["Tools"]
---

# Get Latest Tool Interface

`GET /v1beta2/tool/{tool_uid}/latest-interface`

## Request

- Base URL: `https://api.hunch.tools`
- URL: `https://api.hunch.tools/v1beta2/tool/{tool_uid}/latest-interface`
- Auth: HTTP bearer

This endpoint returns the latest interface schema for a specific tool. The interface
describes the inputs and outputs that the tool accepts and produces.

## Path parameters

- `tool_uid` string, required

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- GetToolInterfaceResponse: The response body returned when requesting a tool's interface.
  - `tool_uid` string, required: The unique identifier of the tool
  - `name` string, required: The name of the tool
  - `interface` ToolInterface, required: Describes the interface of a tool.
    - `blocks` ToolInterfaceBlock[], required
      - `type` 'input' | 'output', required
      - `title` string, required
  - `interface_digest` string, required: A digest of the interface schema. Useful to easily check if the interface has changed.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error
- `456`: Additional Response

---

[API](https://skmtc.dev/hunch/apis/hunch-api.md) - [All operations](https://skmtc.dev/hunch/apis/hunch-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hunch/apis/hunch-api/revisions/f434015fdbee?raw)