List Versions of an Evaluator

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

Successful Response

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

Commit an Evaluator Version

Up Next

Built with

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

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