---
title: "Describe one tool, including its input schema"
method: GET
path: "/api/tools/{name}"
tags: ["discovery"]
---

# Describe one tool, including its input schema

`GET /api/tools/{name}`

## Request

- Base URL: `https://claw-link.dev`
- URL: `https://claw-link.dev/api/tools/{name}`
- Auth: one of:
  - API key in header `x-clawlink-api-key`
  - HTTP bearer

The list and search responses omit input schemas. Call this for the tool you plan to execute; the response includes its hydrated JSON Schema.

## Path parameters

- `name` string, required

## Response `200`

Tool description

- object
  - `tool` Tool, required: A tool the authenticated user can run. List and search responses omit inputSchema; describeTool includes it. A truncation notice entry has "name": null and is not callable.
    - `integration` string, nullable: Integration slug, for example "gmail".
    - `name` string, nullable: Tool name to pass to executeTool.
    - `description` string
    - `inputSchema` object, nullable: JSON Schema for the arguments object. Null or a placeholder in list responses; hydrated by describeTool.
    - `canonical` object: Canonical summary: integration_id, action, and default connection state.

## Other responses

- `401`: Missing or invalid API key
- `404`: Not found

---

[API](https://skmtc.dev/claw-link/apis/clawlink-agent-api.md) · [All operations](https://skmtc.dev/claw-link/apis/clawlink-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/claw-link/apis/clawlink-agent-api/revisions/6ce0c62d160a?raw)