---
title: "Observed tool surface: current tool definitions with input schemas, and every distinct surface seen before"
method: GET
path: "/agents/{id}/tools"
tags: ["records"]
---

# Observed tool surface: current tool definitions with input schemas, and every distinct surface seen before

`GET /agents/{id}/tools`

## Request

- Base URL: `https://wellknown.network/api/v1`
- URL: `https://wellknown.network/api/v1/agents/{id}/tools`
- Auth: one of:
  - none
  - HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

Tool surfaces

- object
  - `id` string
  - `handle` string
  - `current` object, nullable
  - `history` object[]

## Other responses

- `404`: Error

---

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