工作流管理端点
使用 /flows 端点来创建、读取、更新和删除工作流。
如果您想使用 Langflow API 运行工作流，请参阅工作流触发端点。
创建工作流
创建一个新的工作流。
_20curl -X POST \_20 "$LANGFLOW_URL/api/v1/flows/" \_20 -H "accept: application/json" \_20 -H "Content-Type: application/json" \_20 -H "x-api-key: $LANGFLOW_API_KEY" \_20 -d '{_20 "name": "string2",_20 "description": "string",_20 "icon": "string",_20 "icon_bg_color": "#FF0000",_20 "gradient": "string",_20 "data": {},_20 "is_component": false,_20 "updated_at": "2024-12-30T15:48:01.519Z",_20 "webhook": false,_20 "endpoint_name": "string",_20 "tags": [_20 "string"_20 ]_20}'
结果
_17{_17 "name": "string2",_17 "description": "string",_17 "icon": "string",_17 "icon_bg_color": "#FF0000",_17 "gradient": "string",_17 "data": {},_17 "is_component": false,_17 "updated_at": "2025-02-04T21:07:36+00:00",_17 "webhook": false,_17 "endpoint_name": "string",_17 "tags": ["string"],_17 "locked": false,_17 "id": "e8d81c37-714b-49ae-ba82-e61141f020ee",_17 "user_id": "f58396d4-a387-4bb8-b749-f40825c3d9f3",_17 "project_id": "1415de42-8f01-4f36-bf34-539f23e47466"_17}
批量创建工作流
创建多个新的工作流，并返回工作流对象的数组。
_45curl -X POST \_45 "$LANGFLOW_URL/api/v1/flows/batch/" \_45 -H "accept: application/json" \_45 -H "Content-Type: application/json" \_45 -H "x-api-key: $LANGFLOW_API_KEY" \_45 -d '{_45 "flows": [_45 {_45 "name": "string",_45 "description": "string",_45 "icon": "string",_45 "icon_bg_color": "string",_45 "gradient": "string",_45 "data": {},_45 "is_component": false,_45 "updated_at": "2024-12-30T18:36:02.737Z",_45 "webhook": false,_45 "endpoint_name": "string",_45 "tags": [_45 "string"_45 ],_45 "locked": false,_45 "user_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",_45 "project_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"_45 },_45 {_45 "name": "string",_45 "description": "string",_45 "icon": "string",_45 "icon_bg_color": "string",_45 "gradient": "string",_45 "data": {},_45 "is_component": false,_45 "updated_at": "2024-12-30T18:36:02.737Z",_45 "webhook": false,_45 "endpoint_name": "string",_45 "tags": [_45 "string"_45 ],_45 "locked": false,_45 "user_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",_45 "project_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"_45 }_45 ]_45}'
读取工作流
通过 ID 检索特定的工作流。
_10curl -X GET \_10 "$LANGFLOW_URL/api/v1/flows/$FLOW_ID" \_10 -H "accept: application/json" \_10 -H "x-api-key: $LANGFLOW_API_KEY"
结果
_12{_12 "name": "Basic Prompting",_12 "description": "使用 OpenAI 模型执行基础提示。",_12 "icon": "Braces",_12 "icon_bg_color": null,_12 "gradient": "2",_12 "data": {_12 "nodes": [_12 ..._12 ]_12 }_12}
读取工作流列表
返回包含工作流列表的 JSON 对象。
分页检索所有工作流：
_10curl -X GET \_10 "$LANGFLOW_URL/api/v1/flows/?remove_example_flows=false&components_only=false&get_all=true&header_flows=false&page=1&size=50" \_10 -H "accept: application/json" \_10 -H "x-api-key: $LANGFLOW_API_KEY"
要从特定项目中检索工作流，请使用 project_id 查询参数：
_10curl -X GET \_10 "$LANGFLOW_URL/api/v1/flows/?remove_example_flows=true&components_only=false&get_all=false&project_id=$PROJECT_ID&header_flows=false&page=1&size=1" \_10 -H "accept: application/json" \_10 -H "x-api-key: $LANGFLOW_API_KEY"
读取示例工作流
检索示例工作流列表：
_10curl -X GET \_10 "$LANGFLOW_URL/api/v1/flows/basic_examples/" \_10 -H "accept: application/json" \_10 -H "x-api-key: $LANGFLOW_API_KEY"
更新工作流
通过 ID 更新现有工作流。
此示例将 endpoint_name 的值从随机 UUID 更改为 my_new_endpoint_name。
_13curl -X PATCH \_13 "$LANGFLOW_URL/api/v1/flows/$FLOW_ID" \_13 -H "accept: application/json" \_13 -H "Content-Type: application/json" \_13 -H "x-api-key: $LANGFLOW_API_KEY" \_13 -d '{_13 "name": "string",_13 "description": "string",_13 "data": {},_13 "project_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",_13 "endpoint_name": "my_new_endpoint_name",_13 "locked": true_13}'
结果
_17{_17 "name": "string",_17 "description": "string",_17 "icon": "Braces",_17 "icon_bg_color": null,_17 "gradient": "2",_17 "data": {},_17 "is_component": false,_17 "updated_at": "2024-12-30T18:30:22+00:00",_17 "webhook": false,_17 "endpoint_name": "my_new_endpoint_name",_17 "tags": null,_17 "locked": true,_17 "id": "01ce083d-748b-4b8d-97b6-33adbb6a528a",_17 "user_id": "f58396d4-a387-4bb8-b749-f40825c3d9f3",_17 "project_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"_17}
删除工作流
通过 ID 删除特定的工作流。
_10curl -X DELETE \_10 "$LANGFLOW_URL/api/v1/flows/$FLOW_ID" \_10 -H "accept: application/json" \_10 -H "x-api-key: $LANGFLOW_API_KEY"
结果
_10{_10 "message": "工作流已成功删除"_10}
导出 工作流
将指定的工作流导出为 ZIP 文件。
此端点下载一个 ZIP 文件，其中包含请求体中列出的每个工作流 ID 的 Langflow JSON 文件。
_10curl -X POST \_10 "$LANGFLOW_URL/api/v1/flows/download/" \_10 -H "accept: application/json" \_10 -H "Content-Type: application/json" \_10 -H "x-api-key: $LANGFLOW_API_KEY" \_10 -d '[_10 "e1e40c77-0541-41a9-88ab-ddb3419398b5",_10 "92f9a4c5-cfc8-4656-ae63-1f0881163c28"_10]' \_10 --output langflow-flows.zip
结果
_10 % Total % Received % Xferd Average Speed Time Time Time Current_10 Dload Upload Total Spent Left Speed_10100 76437 0 76353 100 84 4516k 5088 --:--:-- --:--:-- --:--:-- 4665k
导入工作流
通过上传 Langflow 兼容的 JSON 文件 导入工作流。
要为工作流指定目标项目，请包含查询参数 folder_id。
在上传工作流之前，目标 folder_id 必须已经存在。调用 /api/v1/projects/ 端点以获取可用文件夹和项目的列表。
此示例将名为 agent-with-astra-db-tool.json 的本地文件上传到由 FOLDER_ID 变量指定的文件夹中：
_10curl -X POST \_10 "$LANGFLOW_URL/api/v1/flows/upload/?folder_id=$FOLDER_ID" \_10 -H "accept: application/json" \_10 -H "Content-Type: multipart/form-data" \_10 -H "x-api-key: $LANGFLOW_API_KEY" \_10 -F "file=@agent-with-astra-db-tool.json;type=application/json"
结果
_11[_11 {_11 "name": "agent-with-astra-db-tool",_11 "description": "",_11 "icon": null,_11 "icon_bg_color": null,_11 "gradient": null,_11 "data": {}_11 ..._11 }_11]
