List Versions of a Agent

GET

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

GET

/v5/agents/:id/versions

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

1 {
2   "records": [
3     {
4       "path": "Banking/Teller Agent",
5       "id": "ag_1234567890",
6       "model": "claude-3-7-sonnet-latest",
7       "tools": [
8         {
9           "type": "file",
10           "link": {
11             "file_id": "pr_1234567890",
12             "version_id": "prv_1234567890"
13           },
14           "on_agent_call": "continue"
15         },
16         {
17           "type": "inline",
18           "json_schema": {
19             "name": "stop",
20             "description": "Call this tool when you have finished your task.",
21             "strict": true,
22             "parameters": {
23               "type": "object",
24               "properties": {
25                 "output": {
26                   "type": "string"
27                 }
28               },
29               "additionalProperties": false,
30               "required": [
31                 "output"
32               ]
33             }
34           },
35           "on_agent_call": "stop"
36         }
37       ],
38       "name": "Teller Agent",
39       "version_id": "agv_1234567890",
40       "created_at": "2024-05-01T12:00:00Z",
41       "updated_at": "2024-05-01T12:00:00Z",
42       "status": "committed",
43       "last_used_at": "2024-05-01T12:00:00Z",
44       "version_logs_count": 1,
45       "total_logs_count": 1,
46       "inputs": [],
47       "endpoint": "chat",
48       "template": [
49         {
50           "role": "system",
51           "content": "You are a helpful digital assistant, helping users navigate our digital banking platform."
52         }
53       ],
54       "provider": "anthropic",
55       "reasoning_effort": 1024,
56       "max_iterations": 3,
57       "type": "agent",
58       "environments": [
59         {
60           "id": "env_ffSVxEBzJcBZ1H5jcNMVj",
61           "created_at": "2023-06-27T23:16:07.992339",
62           "name": "development",
63           "tag": "default"
64         }
65       ],
66       "created_by": {
67         "id": "usr_01RJO1k2spBVqNUt1ASef",
68         "email_address": "raza@humanloop.com",
69         "full_name": "Raza Habib"
70       },
71       "evaluator_aggregates": null
72     }
73   ]
74 }

Get a list of all the versions of a Agent.

Authentication

X-API-KEYstring

API Key authentication via header

Path parameters

idstringRequired

Unique identifier for Agent.

Query parameters

evaluator_aggregatesbooleanOptional

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

Response

Successful Response

recordslist of objects

The list of Agents.

Errors

422

List Versions Agents ID Versions Get Request Unprocessable Entity Error