List Versions

GET

Get a list of all the versions of an Evaluator.

Path parameters

idstringRequired

Unique identifier for the Evaluator.

Query parameters

statusenumOptional

Filter versions by status: 'uncommitted', 'committed'. If no status is provided, all versions are returned.

Allowed values: uncommittedcommitteddeleted

evaluator_aggregatesbooleanOptional

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

Response

This endpoint returns an object.

recordslist of objects

The list of Evaluators.

Errors

GET

1 curl https://api.humanloop.com/v5/evaluators/ev_890bcd/versions \
2      -H "X-API-KEY: <apiKey>"

1 {
2   "records": [
3     {
4       "id": "ev_890bcd",
5       "name": "Accuracy Evaluator",
6       "path": "Shared Evaluators/Accuracy Evaluator",
7       "version_id": "evv_012def",
8       "type": "evaluator",
9       "created_at": "2024-05-01T12:00:00Z",
10       "updated_at": "2024-05-01T12:00:00Z",
11       "status": "committed",
12       "last_used_at": "2024-05-01T12:00:00Z",
13       "spec": {
14         "arguments_type": "target_required",
15         "return_type": "number",
16         "evaluator_type": "python",
17         "code": "def evaluate(answer, target):\n    return 0.5"
18       },
19       "version_logs_count": 1,
20       "total_logs_count": 1,
21       "inputs": [
22         {
23           "name": "answer"
24         }
25       ]
26     }
27   ]
28 }

Built with

1	curl https://api.humanloop.com/v5/evaluators/ev_890bcd/versions \
2	-H "X-API-KEY: <apiKey>"

1	{
2	"records": [
3	{
4	"id": "ev_890bcd",
5	"name": "Accuracy Evaluator",
6	"path": "Shared Evaluators/Accuracy Evaluator",
7	"version_id": "evv_012def",
8	"type": "evaluator",
9	"created_at": "2024-05-01T12:00:00Z",
10	"updated_at": "2024-05-01T12:00:00Z",
11	"status": "committed",
12	"last_used_at": "2024-05-01T12:00:00Z",
13	"spec": {
14	"arguments_type": "target_required",
15	"return_type": "number",
16	"evaluator_type": "python",
17	"code": "def evaluate(answer, target):\n return 0.5"
18	},
19	"version_logs_count": 1,
20	"total_logs_count": 1,
21	"inputs": [
22	{
23	"name": "answer"
24	}
25	]
26	}
27	]
28	}