List Versions of a Flow

GET

Get a list of all the versions of a Flow.

Path parameters

idstringRequired

Unique identifier for Flow.

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

Errors

GET

1 curl -G https://api.humanloop.com/v5/flows/fl_6o701g4jmcanPVHxdqD0O/versions \
2      -H "X-API-KEY: <apiKey>" \
3      -d status=committed

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       "status": "committed",
23       "last_used_at": "2024-07-08T22:40:35.656915",
24       "version_logs_count": 0,
25       "commit_message": "Initial commit",
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     }
41   ]
42 }

Commit a Flow Version

Up Next

Built with

1	curl -G https://api.humanloop.com/v5/flows/fl_6o701g4jmcanPVHxdqD0O/versions \
2	-H "X-API-KEY: <apiKey>" \
3	-d status=committed

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	"status": "committed",
23	"last_used_at": "2024-07-08T22:40:35.656915",
24	"version_logs_count": 0,
25	"commit_message": "Initial commit",
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	}
41	]
42	}