List Versions of a Tool

GET

https://api.humanloop.com/v5/tools/:id/versions

Get a list of all the versions of a Tool.

X-API-KEYstring

API Key authentication via header

idstringRequired

Unique identifier for the Tool.

evaluator_aggregatesbooleanOptional

Whether to include Evaluator aggregate results for the versions in the response

Successful Response

recordslist of objects

The list of Tools.

1	{
2	"records": [
3	{
4	"path": "math-tool",
5	"id": "tl_789ghi",
6	"name": "math-tool",
7	"version_id": "tv_012jkl",
8	"created_at": "2024-05-01T12:00:00Z",
9	"updated_at": "2024-05-01T12:00:00Z",
10	"last_used_at": "2024-05-01T12:00:00Z",
11	"version_logs_count": 1,
12	"total_logs_count": 1,
13	"inputs": [
14	{
15	"name": "operation"
16	}
17	],
18	"version_name": "math-tool-v1",
19	"version_description": "Simple math tool that multiplies two numbers",
20	"type": "tool"
21	}
22	]
23	}

1	from humanloop import Humanloop
2	client = Humanloop(api_key="YOUR_API_KEY", )
3	client.tools.list_versions(id='tl_789ghi', )