Humanloop Documentation and API Reference

Create or update a Flow.

Flows can also be identified by the ID or their path.

If you provide a commit message, then the new version will be committed; otherwise it will be uncommitted. If you try to commit an already committed version, an exception will be raised.

Request

This endpoint expects an object.

attributesmap from strings to anyRequired

A key-value object identifying the Flow Version.

pathstringOptional

Path of the Flow, including the name. This locates the Flow in the Humanloop filesystem and is used as as a unique identifier. For example: folder/name or just name.

idstringOptional

ID for an existing Flow.

commit_messagestringOptional

Message describing the changes made.

Response

Successful Response

pathstring

Path of the Flow, including the name, which is used as a unique identifier.

idstring

Unique identifier for the Flow. Starts with fl_.

attributesmap from strings to any

A key-value object identifying the Flow Version.

namestring

Name of the Flow.

version_idstring

Unique identifier for the specific Flow Version. If no query params provided, the default deployed Flow Version is returned.

created_atdatetime

updated_atdatetime

statusenum

Allowed values: uncommittedcommitteddeleted

The status of the Flow Version.

last_used_atdatetime

version_logs_countinteger

The number of logs that have been generated for this Flow Version

directory_idstringOptional

ID of the directory that the file is in on Humanloop.

commit_messagestringOptional

Message describing the changes made. If provided, a committed version of the Flow is created. Otherwise, an uncommitted version is created.

type"flow"OptionalDefaults to flow

environmentslist of objectsOptional

The list of environments the Flow Version is deployed to.

created_byanyOptional

The user who created the Flow.

committed_byanyOptional

The user who committed the Flow Version.

committed_atdatetimeOptional

The date and time the Flow Version was committed.

evaluator_aggregateslist of objectsOptional

Aggregation of Evaluator results for the Flow Version.

evaluatorslist of objectsOptional

The list of Monitoring Evaluators associated with the Flow Version.

1	curl -X POST https://api.humanloop.com/v5/flows \
2	-H "X-API-KEY: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"attributes": {
6	"prompt": {
7	"template": "You are a helpful medical assistant helping with medical anamnesis. Answer {{question}}",
8	"model": "gpt-4o",
9	"temperature": 0.8
10	},
11	"tool": {
12	"name": "retrieval_tool_v3",
13	"description": "Retrieval tool for MedQA.",
14	"source_code": "def retrieval_tool(question: str) -> str:\n pass\n"
15	},
16	"commit_message": "Initial commit"
17	},
18	"path": "Personal Projects/MedQA Flow"
19	}'

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

Upsert Flow

Request

Response

Errors