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.

422

List Versions Tools ID Versions Get Request Unprocessable Entity Error

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', )