List Versions of a Flow

GET

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

GET

/v5/flows/:id/versions

1 import { HumanloopClient } from "humanloop";
2 
3 const client = new HumanloopClient({ apiKey: "YOUR_API_KEY" });
4 await client.flows.listVersions("fl_6o701g4jmcanPVHxdqD0O");

1 {
2   "records": [
3     {
4       "path": "Personal Projects/MedQA",
5       "id": "fl_6o701g4jmcanPVHxdqD0O",
6       "attributes": {
7         "prompt": {
8           "template": "You are a helpful assistant helping with medical anamnesis",
9           "model": "gpt-4o",
10           "temperature": 0.8
11         },
12         "tool": {
13           "name": "retrieval_tool_v3",
14           "description": "Retrieval tool for MedQA.",
15           "source_code": "def retrieval_tool(question: str) -> str:\n    pass\n"
16         }
17       },
18       "name": "MedQA Flow",
19       "version_id": "flv_7ZNQREaScH0JkhUwtXrLN",
20       "created_at": "2024-07-08T22:40:35.656915",
21       "updated_at": "2024-07-08T22:40:35.656915",
22       "last_used_at": "2024-07-08T22:40:35.656915",
23       "version_logs_count": 0,
24       "version_name": "medqa-flow-v1",
25       "version_description": "Initial version",
26       "type": "flow",
27       "environments": [
28         {
29           "id": "env_ffSVxEBzJcBZ1H5jcNMVj",
30           "created_at": "2023-06-27T23:16:07.992339",
31           "name": "development",
32           "tag": "default"
33         }
34       ],
35       "created_by": {
36         "id": "usr_01RJO1k2spBVqNUt1ASef",
37         "email_address": "raza@humanloop.com",
38         "full_name": "Raza Habib"
39       },
40       "evaluator_aggregates": null
41     }
42   ]
43 }

Get a list of all the versions of a Flow.

Authentication

X-API-KEYstring

API Key authentication via header

Path parameters

idstringRequired

Unique identifier for Flow.

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 Flows.

Errors

422

List Versions Flows ID Versions Get Request Unprocessable Entity Error