{
"components": {
"schemas": {
"AccessTypeEnum": {
"enum": [
"PRIVATE",
"PUBLIC"
],
"title": "AccessTypeEnum",
"type": "string"
},
"AuthSettings": {
"description": "Model representing authentication settings for MCP.",
"properties": {
"auth_type": {
"default": "none",
"enum": [
"none",
"apikey",
"oauth"
],
"title": "Auth Type",
"type": "string"
},
"oauth_auth_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Oauth Auth Url"
},
"oauth_callback_path": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Oauth Callback Path"
},
"oauth_callback_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Oauth Callback Url"
},
"oauth_client_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Oauth Client Id"
},
"oauth_client_secret": {
"anyOf": [
{
"format": "password",
"type": "string",
"writeOnly": true
},
{
"type": "null"
}
],
"title": "Oauth Client Secret"
},
"oauth_host": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Oauth Host"
},
"oauth_mcp_scope": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Oauth Mcp Scope"
},
"oauth_port": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Oauth Port"
},
"oauth_provider_scope": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Oauth Provider Scope"
},
"oauth_server_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Oauth Server Url"
},
"oauth_token_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Oauth Token Url"
}
},
"title": "AuthSettings",
"type": "object"
},
"Body_build_flow_api_v1_build__flow_id__flow_post": {
"properties": {
"data": {
"anyOf": [
{
"$ref": "#/components/schemas/FlowDataRequest"
},
{
"type": "null"
}
]
},
"files": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Files"
},
"inputs": {
"anyOf": [
{
"$ref": "#/components/schemas/InputValueRequest"
},
{
"type": "null"
}
]
}
},
"title": "Body_build_flow_api_v1_build__flow_id__flow_post",
"type": "object"
},
"Body_build_public_tmp_api_v1_build_public_tmp__flow_id__flow_post": {
"properties": {
"files": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Files"
},
"inputs": {
"anyOf": [
{
"$ref": "#/components/schemas/InputValueRequest"
},
{
"type": "null"
}
]
}
},
"title": "Body_build_public_tmp_api_v1_build_public_tmp__flow_id__flow_post",
"type": "object"
},
"Body_experimental_run_flow_api_v1_run_advanced__flow_id_or_name__post": {
"properties": {
"inputs": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/InputValueRequest"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Inputs"
},
"outputs": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Outputs"
},
"session_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Session Id"
},
"stream": {
"default": false,
"title": "Stream",
"type": "boolean"
},
"tweaks": {
"anyOf": [
{
"$ref": "#/components/schemas/Tweaks"
},
{
"type": "null"
}
]
}
},
"title": "Body_experimental_run_flow_api_v1_run_advanced__flow_id_or_name__post",
"type": "object"
},
"Body_simplified_run_flow_api_v1_run__flow_id_or_name__post": {
"properties": {
"context": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Context"
},
"input_request": {
"anyOf": [
{
"$ref": "#/components/schemas/SimplifiedAPIRequest"
},
{
"type": "null"
}
]
}
},
"title": "Body_simplified_run_flow_api_v1_run__flow_id_or_name__post",
"type": "object"
},
"Body_upload_file_api_v1_files_upload__flow_id__post": {
"properties": {
"file": {
"contentMediaType": "application/octet-stream",
"title": "File",
"type": "string"
}
},
"required": [
"file"
],
"title": "Body_upload_file_api_v1_files_upload__flow_id__post",
"type": "object"
},
"Body_upload_file_api_v1_flows_upload__post": {
"properties": {
"file": {
"anyOf": [
{
"contentMediaType": "application/octet-stream",
"type": "string"
},
{
"type": "null"
}
],
"title": "File"
}
},
"title": "Body_upload_file_api_v1_flows_upload__post",
"type": "object"
},
"Body_upload_file_api_v1_projects_upload__post": {
"properties": {
"file": {
"anyOf": [
{
"contentMediaType": "application/octet-stream",
"type": "string"
},
{
"type": "null"
}
],
"title": "File"
}
},
"title": "Body_upload_file_api_v1_projects_upload__post",
"type": "object"
},
"Body_upload_user_file_api_v2_files__post": {
"properties": {
"file": {
"contentMediaType": "application/octet-stream",
"title": "File",
"type": "string"
}
},
"required": [
"file"
],
"title": "Body_upload_user_file_api_v2_files__post",
"type": "object"
},
"Body_upload_user_file_api_v2_files_post": {
"properties": {
"file": {
"contentMediaType": "application/octet-stream",
"title": "File",
"type": "string"
}
},
"required": [
"file"
],
"title": "Body_upload_user_file_api_v2_files_post",
"type": "object"
},
"CancelFlowResponse": {
"description": "Response model for flow build cancellation.",
"properties": {
"message": {
"title": "Message",
"type": "string"
},
"success": {
"title": "Success",
"type": "boolean"
}
},
"required": [
"success",
"message"
],
"title": "CancelFlowResponse",
"type": "object"
},
"ChatOutputResponse": {
"description": "Chat output response schema.",
"properties": {
"component_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Component Id"
},
"files": {
"default": [],
"items": {
"$ref": "#/components/schemas/lfx__utils__schemas__File"
},
"title": "Files",
"type": "array"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"anyOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"type": "object"
}
]
},
"type": "array"
}
],
"title": "Message"
},
"sender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "Machine",
"title": "Sender"
},
"sender_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "AI",
"title": "Sender Name"
},
"session_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Session Id"
},
"stream_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Stream Url"
},
"type": {
"title": "Type",
"type": "string"
}
},
"required": [
"message",
"type"
],
"title": "ChatOutputResponse",
"type": "object"
},
"CodeContent": {
"additionalProperties": true,
"type": "object"
},
"ComponentOutput": {
"description": "Component output schema.",
"properties": {
"content": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Content"
},
"metadata": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Metadata"
},
"status": {
"$ref": "#/$defs/JobStatus"
},
"type": {
"description": "Type of the component output (e.g., 'message', 'data', 'tool', 'text')",
"title": "Type",
"type": "string"
}
},
"required": [
"type",
"status"
],
"title": "ComponentOutput",
"type": "object"
},
"ComposerUrlResponse": {
"description": "Response model for MCP Composer connection details.",
"properties": {
"error_message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error Message"
},
"legacy_sse_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Legacy Sse Url"
},
"project_id": {
"title": "Project Id",
"type": "string"
},
"streamable_http_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Streamable Http Url"
},
"uses_composer": {
"title": "Uses Composer",
"type": "boolean"
}
},
"required": [
"project_id",
"uses_composer"
],
"title": "ComposerUrlResponse",
"type": "object"
},
"ConfigResponse": {
"description": "Full configuration response for authenticated users.\n\nThe 'type' field is a discriminator to distinguish from PublicConfigResponse.",
"properties": {
"allow_custom_components": {
"title": "Allow Custom Components",
"type": "boolean"
},
"auto_saving": {
"title": "Auto Saving",
"type": "boolean"
},
"auto_saving_interval": {
"title": "Auto Saving Interval",
"type": "integer"
},
"default_folder_name": {
"title": "Default Folder Name",
"type": "string"
},
"event_delivery": {
"enum": [
"polling",
"streaming",
"direct"
],
"title": "Event Delivery",
"type": "string"
},
"feature_flags": {
"$ref": "#/components/schemas/FeatureFlags"
},
"frontend_timeout": {
"title": "Frontend Timeout",
"type": "integer"
},
"health_check_max_retries": {
"title": "Health Check Max Retries",
"type": "integer"
},
"hide_getting_started_progress": {
"title": "Hide Getting Started Progress",
"type": "boolean"
},
"max_file_size_upload": {
"title": "Max File Size Upload",
"type": "integer"
},
"mcp_base_url": {
"title": "Mcp Base Url",
"type": "string"
},
"public_flow_cleanup_interval": {
"title": "Public Flow Cleanup Interval",
"type": "integer"
},
"public_flow_expiration": {
"title": "Public Flow Expiration",
"type": "integer"
},
"serialization_max_items_length": {
"title": "Serialization Max Items Length",
"type": "integer"
},
"serialization_max_text_length": {
"title": "Serialization Max Text Length",
"type": "integer"
},
"type": {
"const": "full",
"default": "full",
"title": "Type",
"type": "string"
},
"voice_mode_available": {
"title": "Voice Mode Available",
"type": "boolean"
},
"webhook_auth_enable": {
"title": "Webhook Auth Enable",
"type": "boolean"
},
"webhook_polling_interval": {
"title": "Webhook Polling Interval",
"type": "integer"
}
},
"required": [
"feature_flags",
"max_file_size_upload",
"event_delivery",
"voice_mode_available",
"frontend_timeout",
"mcp_base_url",
"serialization_max_items_length",
"serialization_max_text_length",
"auto_saving",
"auto_saving_interval",
"health_check_max_retries",
"webhook_polling_interval",
"public_flow_cleanup_interval",
"public_flow_expiration",
"webhook_auth_enable",
"default_folder_name",
"hide_getting_started_progress",
"allow_custom_components"
],
"title": "ConfigResponse",
"type": "object"
},
"ContentBlock": {
"description": "A block of content that can contain different types of content.",
"properties": {
"allow_markdown": {
"default": true,
"title": "Allow Markdown",
"type": "boolean"
},
"contents": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Contents",
"type": "array"
},
"media_url": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Media Url"
},
"title": {
"title": "Title",
"type": "string"
}
},
"required": [
"title",
"contents"
],
"title": "ContentBlock",
"type": "object"
},
"ErrorContent": {
"additionalProperties": true,
"type": "object"
},
"ErrorDetail": {
"description": "Error detail schema.",
"properties": {
"code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Code"
},
"details": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Details"
},
"error": {
"title": "Error",
"type": "string"
}
},
"required": [
"error"
],
"title": "ErrorDetail",
"type": "object"
},
"EventDeliveryType": {
"enum": [
"streaming",
"direct",
"polling"
],
"title": "EventDeliveryType",
"type": "string"
},
"FeatureFlags": {
"additionalProperties": false,
"properties": {
"mvp_components": {
"default": false,
"title": "Mvp Components",
"type": "boolean"
},
"wxo_deployments": {
"default": false,
"title": "Wxo Deployments",
"type": "boolean"
}
},
"title": "FeatureFlags",
"type": "object"
},
"FlowCreate": {
"properties": {
"access_type": {
"$ref": "#/components/schemas/AccessTypeEnum",
"default": "PRIVATE"
},
"action_description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The description of the action associated with the flow",
"title": "Action Description"
},
"action_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the action associated with the flow",
"title": "Action Name"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Data"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"endpoint_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Endpoint Name"
},
"folder_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Folder Id"
},
"fs_path": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Fs Path"
},
"gradient": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Gradient"
},
"icon": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Icon"
},
"icon_bg_color": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Icon Bg Color"
},
"id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Id"
},
"is_component": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": false,
"title": "Is Component"
},
"locked": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": false,
"title": "Locked"
},
"mcp_enabled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": false,
"description": "Can be exposed in the MCP server",
"title": "Mcp Enabled"
},
"name": {
"title": "Name",
"type": "string"
},
"tags": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Tags"
},
"updated_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Updated At"
},
"user_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "User Id"
},
"webhook": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": false,
"description": "Can be used on the webhook endpoint",
"title": "Webhook"
}
},
"required": [
"name"
],
"title": "FlowCreate",
"type": "object"
},
"FlowDataRequest": {
"properties": {
"edges": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Edges",
"type": "array"
},
"nodes": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Nodes",
"type": "array"
},
"viewport": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Viewport"
}
},
"required": [
"nodes",
"edges"
],
"title": "FlowDataRequest",
"type": "object"
},
"FlowEventCreate": {
"properties": {
"summary": {
"default": "",
"maxLength": 500,
"title": "Summary",
"type": "string"
},
"type": {
"enum": [
"component_added",
"component_removed",
"component_configured",
"connection_added",
"connection_removed",
"flow_updated",
"flow_settled"
],
"title": "Type",
"type": "string"
}
},
"required": [
"type"
],
"title": "FlowEventCreate",
"type": "object"
},
"FlowEventResponse": {
"properties": {
"summary": {
"title": "Summary",
"type": "string"
},
"timestamp": {
"title": "Timestamp",
"type": "number"
},
"type": {
"title": "Type",
"type": "string"
}
},
"required": [
"type",
"timestamp",
"summary"
],
"title": "FlowEventResponse",
"type": "object"
},
"FlowEventsResponse": {
"properties": {
"events": {
"items": {
"$ref": "#/components/schemas/FlowEventResponse"
},
"title": "Events",
"type": "array"
},
"settled": {
"title": "Settled",
"type": "boolean"
}
},
"required": [
"events",
"settled"
],
"title": "FlowEventsResponse",
"type": "object"
},
"FlowHeader": {
"description": "Model representing a header for a flow - Without the data.",
"properties": {
"access_type": {
"anyOf": [
{
"$ref": "#/components/schemas/AccessTypeEnum"
},
{
"type": "null"
}
],
"description": "The access type of the flow"
},
"action_description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The description of the action associated with the flow",
"title": "Action Description"
},
"action_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the action associated with the flow",
"title": "Action Name"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"description": "The data of the component, if is_component is True",
"title": "Data"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "A description of the flow",
"title": "Description"
},
"endpoint_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the endpoint associated with this flow",
"title": "Endpoint Name"
},
"folder_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"description": "The ID of the folder containing the flow. None if not associated with a folder",
"title": "Folder Id"
},
"id": {
"description": "Unique identifier for the flow",
"format": "uuid",
"title": "Id",
"type": "string"
},
"is_component": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Flag indicating whether the flow is a component",
"title": "Is Component"
},
"mcp_enabled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Flag indicating whether the flow is exposed in the MCP server",
"title": "Mcp Enabled"
},
"name": {
"description": "The name of the flow",
"title": "Name",
"type": "string"
},
"tags": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "The tags of the flow",
"title": "Tags"
}
},
"required": [
"id",
"name"
],
"title": "FlowHeader",
"type": "object"
},
"FlowListCreate": {
"properties": {
"flows": {
"items": {
"$ref": "#/components/schemas/FlowCreate"
},
"title": "Flows",
"type": "array"
}
},
"required": [
"flows"
],
"title": "FlowListCreate",
"type": "object"
},
"FlowRead": {
"properties": {
"access_type": {
"$ref": "#/components/schemas/AccessTypeEnum",
"default": "PRIVATE"
},
"action_description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The description of the action associated with the flow",
"title": "Action Description"
},
"action_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the action associated with the flow",
"title": "Action Name"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Data"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"endpoint_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Endpoint Name"
},
"folder_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Folder Id"
},
"gradient": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Gradient"
},
"icon": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Icon"
},
"icon_bg_color": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Icon Bg Color"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"is_component": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": false,
"title": "Is Component"
},
"locked": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": false,
"title": "Locked"
},
"mcp_enabled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": false,
"description": "Can be exposed in the MCP server",
"title": "Mcp Enabled"
},
"name": {
"title": "Name",
"type": "string"
},
"tags": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "The tags of the flow",
"title": "Tags"
},
"updated_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Updated At"
},
"user_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "User Id"
},
"webhook": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": false,
"description": "Can be used on the webhook endpoint",
"title": "Webhook"
}
},
"required": [
"name",
"id",
"user_id",
"folder_id"
],
"title": "FlowRead",
"type": "object"
},
"FlowUpdate": {
"properties": {
"access_type": {
"anyOf": [
{
"$ref": "#/components/schemas/AccessTypeEnum"
},
{
"type": "null"
}
]
},
"action_description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Action Description"
},
"action_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Action Name"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Data"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"endpoint_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Endpoint Name"
},
"folder_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Folder Id"
},
"fs_path": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Fs Path"
},
"locked": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Locked"
},
"mcp_enabled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Mcp Enabled"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name"
}
},
"title": "FlowUpdate",
"type": "object"
},
"FolderCreate": {
"properties": {
"auth_settings": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"description": "Authentication settings for the folder/project",
"title": "Auth Settings"
},
"components_list": {
"anyOf": [
{
"items": {
"format": "uuid",
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Components List"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"flows_list": {
"anyOf": [
{
"items": {
"format": "uuid",
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Flows List"
},
"name": {
"title": "Name",
"type": "string"
}
},
"required": [
"name"
],
"title": "FolderCreate",
"type": "object"
},
"FolderRead": {
"properties": {
"auth_settings": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"description": "Authentication settings for the folder/project",
"title": "Auth Settings"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"parent_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Id"
}
},
"required": [
"name",
"id",
"parent_id"
],
"title": "FolderRead",
"type": "object"
},
"FolderReadWithFlows": {
"properties": {
"auth_settings": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"description": "Authentication settings for the folder/project",
"title": "Auth Settings"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"flows": {
"default": [],
"items": {
"$ref": "#/components/schemas/FlowRead"
},
"title": "Flows",
"type": "array"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"parent_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Id"
}
},
"required": [
"name",
"id",
"parent_id"
],
"title": "FolderReadWithFlows",
"type": "object"
},
"FolderUpdate": {
"properties": {
"auth_settings": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Auth Settings"
},
"components": {
"items": {
"format": "uuid",
"type": "string"
},
"title": "Components",
"type": "array"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"flows": {
"items": {
"format": "uuid",
"type": "string"
},
"title": "Flows",
"type": "array"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name"
},
"parent_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Id"
}
},
"title": "FolderUpdate",
"type": "object"
},
"FolderWithPaginatedFlows": {
"properties": {
"flows": {
"$ref": "#/components/schemas/Page_FlowRead_"
},
"folder": {
"$ref": "#/components/schemas/FolderRead"
}
},
"required": [
"folder",
"flows"
],
"title": "FolderWithPaginatedFlows",
"type": "object"
},
"GraphData": {
"properties": {
"edges": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Edges",
"type": "array"
},
"nodes": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Nodes",
"type": "array"
},
"viewport": {
"anyOf": [
{
"$ref": "#/components/schemas/ViewPort"
},
{
"type": "null"
}
]
}
},
"required": [
"nodes",
"edges"
],
"title": "GraphData",
"type": "object"
},
"GraphDumpResponse": {
"properties": {
"data": {
"$ref": "#/components/schemas/GraphData"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"endpoint_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Endpoint Name"
},
"is_component": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Component"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name"
}
},
"required": [
"data"
],
"title": "GraphDumpResponse",
"type": "object"
},
"HTTPValidationError": {
"properties": {
"detail": {
"items": {
"$ref": "#/components/schemas/ValidationError"
},
"title": "Detail",
"type": "array"
}
},
"title": "HTTPValidationError",
"type": "object"
},
"HealthResponse": {
"properties": {
"chat": {
"default": "error check the server logs",
"title": "Chat",
"type": "string"
},
"db": {
"default": "error check the server logs",
"title": "Db",
"type": "string"
},
"status": {
"default": "nok",
"title": "Status",
"type": "string"
}
},
"title": "HealthResponse",
"type": "object"
},
"InputValueRequest": {
"additionalProperties": false,
"examples": [
{
"components": [
"components_id",
"Component Name"
],
"input_value": "input_value",
"session": "session_id"
},
{
"components": [
"Component Name"
],
"input_value": "input_value"
},
{
"input_value": "input_value"
},
{
"components": [
"Component Name"
],
"input_value": "input_value",
"session": "session_id"
},
{
"input_value": "input_value",
"session": "session_id"
},
{
"input_value": "input_value",
"type": "chat"
},
{
"input_value": "{\"key\": \"value\"}",
"type": "json"
}
],
"properties": {
"client_request_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Client-side timestamp in milliseconds when the request was initiated. Used to calculate accurate end-to-end duration.",
"title": "Client Request Time"
},
"components": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": [],
"title": "Components"
},
"input_value": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Input Value"
},
"session": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Session"
},
"type": {
"anyOf": [
{
"enum": [
"chat",
"text",
"any"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "any",
"description": "Defines on which components the input value should be applied. 'any' applies to all input components.",
"title": "Type"
}
},
"title": "InputValueRequest",
"type": "object"
},
"JSONContent": {
"additionalProperties": true,
"type": "object"
},
"JobStatus": {
"description": "Job execution status.",
"enum": [
"queued",
"in_progress",
"completed",
"failed",
"cancelled",
"timed_out"
],
"title": "JobStatus",
"type": "string"
},
"MCPInstallRequest": {
"properties": {
"client": {
"title": "Client",
"type": "string"
},
"transport": {
"anyOf": [
{
"enum": [
"sse",
"streamablehttp"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Transport"
}
},
"required": [
"client"
],
"title": "MCPInstallRequest",
"type": "object"
},
"MCPProjectUpdateRequest": {
"description": "Request model for updating MCP project settings including auth.",
"properties": {
"auth_settings": {
"anyOf": [
{
"$ref": "#/components/schemas/AuthSettings"
},
{
"type": "null"
}
]
},
"settings": {
"items": {
"$ref": "#/components/schemas/MCPSettings"
},
"title": "Settings",
"type": "array"
}
},
"required": [
"settings"
],
"title": "MCPProjectUpdateRequest",
"type": "object"
},
"MCPServerConfig": {
"additionalProperties": true,
"description": "Pydantic model for MCP server configuration.",
"properties": {
"args": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Args"
},
"command": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Command"
},
"env": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"title": "Env"
},
"headers": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"title": "Headers"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url"
}
},
"title": "MCPServerConfig",
"type": "object"
},
"MCPSettings": {
"description": "Model representing MCP settings for a flow.",
"properties": {
"action_description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Action Description"
},
"action_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Action Name"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"mcp_enabled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Mcp Enabled"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name"
}
},
"required": [
"id"
],
"title": "MCPSettings",
"type": "object"
},
"MediaContent": {
"additionalProperties": true,
"type": "object"
},
"MessageRead": {
"properties": {
"category": {
"default": "message",
"title": "Category",
"type": "string"
},
"content_blocks": {
"items": {
"$ref": "#/components/schemas/ContentBlock"
},
"title": "Content Blocks",
"type": "array"
},
"context_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context Id"
},
"edit": {
"default": false,
"title": "Edit",
"type": "boolean"
},
"error": {
"default": false,
"title": "Error",
"type": "boolean"
},
"files": {
"items": {
"type": "string"
},
"title": "Files",
"type": "array"
},
"flow_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Flow Id"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"properties": {
"$ref": "#/components/schemas/Properties"
},
"sender": {
"title": "Sender",
"type": "string"
},
"sender_name": {
"title": "Sender Name",
"type": "string"
},
"session_id": {
"title": "Session Id",
"type": "string"
},
"session_metadata": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Session Metadata"
},
"text": {
"title": "Text",
"type": "string"
},
"timestamp": {
"format": "date-time",
"title": "Timestamp",
"type": "string"
}
},
"required": [
"sender",
"sender_name",
"session_id",
"text",
"id",
"flow_id"
],
"title": "MessageRead",
"type": "object"
},
"MessageResponse": {
"properties": {
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Category"
},
"content_blocks": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/ContentBlock"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Content Blocks"
},
"context_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context Id"
},
"duration": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Duration"
},
"edit": {
"title": "Edit",
"type": "boolean"
},
"files": {
"default": [],
"items": {
"type": "string"
},
"title": "Files",
"type": "array"
},
"flow_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Flow Id"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Id"
},
"properties": {
"anyOf": [
{
"$ref": "#/components/schemas/Properties"
},
{
"type": "null"
}
]
},
"sender": {
"title": "Sender",
"type": "string"
},
"sender_name": {
"title": "Sender Name",
"type": "string"
},
"session_id": {
"title": "Session Id",
"type": "string"
},
"session_metadata": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Session Metadata"
},
"text": {
"title": "Text",
"type": "string"
},
"timestamp": {
"format": "date-time",
"title": "Timestamp",
"type": "string"
}
},
"required": [
"sender",
"sender_name",
"session_id",
"text",
"edit"
],
"title": "MessageResponse",
"type": "object"
},
"MessageUpdate": {
"properties": {
"context_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context Id"
},
"edit": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Edit"
},
"error": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Error"
},
"files": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Files"
},
"properties": {
"anyOf": [
{
"$ref": "#/components/schemas/Properties"
},
{
"type": "null"
}
]
},
"sender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Sender"
},
"sender_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Sender Name"
},
"session_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Session Id"
},
"session_metadata": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Session Metadata"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Text"
}
},
"title": "MessageUpdate",
"type": "object"
},
"OpenAIResponsesRequest": {
"description": "OpenAI-compatible responses request with flow_id as model parameter.",
"properties": {
"background": {
"default": false,
"description": "Whether to process in background",
"title": "Background",
"type": "boolean"
},
"include": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Additional response data to include, e.g., ['tool_call.results']",
"title": "Include"
},
"input": {
"description": "The input text to process",
"title": "Input",
"type": "string"
},
"model": {
"description": "The flow ID to execute (used instead of OpenAI model)",
"title": "Model",
"type": "string"
},
"previous_response_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "ID of previous response to continue conversation",
"title": "Previous Response Id"
},
"stream": {
"default": false,
"description": "Whether to stream the response",
"title": "Stream",
"type": "boolean"
},
"tools": {
"anyOf": [
{
"items": {},
"type": "array"
},
{
"type": "null"
}
],
"description": "Tools are not supported yet",
"title": "Tools"
}
},
"required": [
"model",
"input"
],
"title": "OpenAIResponsesRequest",
"type": "object"
},
"Page_FlowRead_": {
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/FlowRead"
},
"title": "Items",
"type": "array"
},
"page": {
"minimum": 1.0,
"title": "Page",
"type": "integer"
},
"pages": {
"minimum": 0.0,
"title": "Pages",
"type": "integer"
},
"size": {
"minimum": 1.0,
"title": "Size",
"type": "integer"
},
"total": {
"minimum": 0.0,
"title": "Total",
"type": "integer"
}
},
"required": [
"items",
"total",
"page",
"size",
"pages"
],
"title": "Page[FlowRead]",
"type": "object"
},
"Page_TransactionLogsResponse_": {
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/TransactionLogsResponse"
},
"title": "Items",
"type": "array"
},
"page": {
"minimum": 1.0,
"title": "Page",
"type": "integer"
},
"pages": {
"minimum": 0.0,
"title": "Pages",
"type": "integer"
},
"size": {
"minimum": 1.0,
"title": "Size",
"type": "integer"
},
"total": {
"minimum": 0.0,
"title": "Total",
"type": "integer"
}
},
"required": [
"items",
"total",
"page",
"size",
"pages"
],
"title": "Page[TransactionLogsResponse]",
"type": "object"
},
"Properties": {
"properties": {
"allow_markdown": {
"default": false,
"title": "Allow Markdown",
"type": "boolean"
},
"background_color": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Background Color"
},
"build_duration": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Build Duration"
},
"edited": {
"default": false,
"title": "Edited",
"type": "boolean"
},
"icon": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Icon"
},
"positive_feedback": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Positive Feedback"
},
"source": {
"$ref": "#/components/schemas/Source"
},
"state": {
"default": "complete",
"enum": [
"partial",
"complete"
],
"title": "State",
"type": "string"
},
"targets": {
"default": [],
"items": {},
"title": "Targets",
"type": "array"
},
"text_color": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Text Color"
},
"usage": {
"anyOf": [
{
"$ref": "#/components/schemas/Usage"
},
{
"type": "null"
}
]
}
},
"title": "Properties",
"type": "object"
},
"PublicConfigResponse": {
"description": "Configuration response for public/unauthenticated endpoints like the public playground.\n\nContains only the configuration values needed for public features, without sensitive data.\nThe 'type' field is a discriminator to distinguish from full ConfigResponse.",
"properties": {
"allow_custom_components": {
"title": "Allow Custom Components",
"type": "boolean"
},
"event_delivery": {
"enum": [
"polling",
"streaming",
"direct"
],
"title": "Event Delivery",
"type": "string"
},
"feature_flags": {
"$ref": "#/components/schemas/FeatureFlags"
},
"frontend_timeout": {
"title": "Frontend Timeout",
"type": "integer"
},
"max_file_size_upload": {
"title": "Max File Size Upload",
"type": "integer"
},
"mcp_base_url": {
"title": "Mcp Base Url",
"type": "string"
},
"type": {
"const": "public",
"default": "public",
"title": "Type",
"type": "string"
},
"voice_mode_available": {
"title": "Voice Mode Available",
"type": "boolean"
}
},
"required": [
"feature_flags",
"max_file_size_upload",
"event_delivery",
"voice_mode_available",
"frontend_timeout",
"mcp_base_url",
"allow_custom_components"
],
"title": "PublicConfigResponse",
"type": "object"
},
"ResultData": {
"properties": {
"artifacts": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Artifacts"
},
"component_display_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Component Display Name"
},
"component_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Component Id"
},
"duration": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Duration"
},
"logs": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Logs"
},
"messages": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/ChatOutputResponse"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Messages"
},
"outputs": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Outputs"
},
"results": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Results"
},
"timedelta": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Timedelta"
},
"token_usage": {
"anyOf": [
{
"$ref": "#/components/schemas/Usage"
},
{
"type": "null"
}
]
},
"used_frozen_result": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": false,
"title": "Used Frozen Result"
}
},
"title": "ResultData",
"type": "object"
},
"RunOutputs": {
"properties": {
"inputs": {
"additionalProperties": true,
"title": "Inputs",
"type": "object"
},
"outputs": {
"items": {
"anyOf": [
{
"$ref": "#/components/schemas/ResultData"
},
{
"type": "null"
}
]
},
"title": "Outputs",
"type": "array"
}
},
"title": "RunOutputs",
"type": "object"
},
"RunResponse": {
"description": "Run response schema.",
"properties": {
"outputs": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/RunOutputs"
},
"type": "array"
},
{
"type": "null"
}
],
"default": [],
"title": "Outputs"
},
"session_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Session Id"
}
},
"title": "RunResponse",
"type": "object"
},
"SimplifiedAPIRequest": {
"properties": {
"input_type": {
"anyOf": [
{
"enum": [
"chat",
"text",
"any"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "chat",
"description": "The input type",
"title": "Input Type"
},
"input_value": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The input value",
"title": "Input Value"
},
"output_component": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "",
"description": "If there are multiple output components, you can specify the component to get the output from.",
"title": "Output Component"
},
"output_type": {
"anyOf": [
{
"enum": [
"chat",
"text",
"any",
"debug"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "chat",
"description": "The output type",
"title": "Output Type"
},
"session_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The session id",
"title": "Session Id"
},
"tweaks": {
"anyOf": [
{
"$ref": "#/components/schemas/Tweaks"
},
{
"type": "null"
}
],
"description": "The tweaks"
}
},
"title": "SimplifiedAPIRequest",
"type": "object"
},
"Source": {
"properties": {
"display_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The display name of the source component.",
"title": "Display Name"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The id of the source component.",
"title": "Id"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The source of the message. Normally used to display the model name (e.g. 'gpt-4o')",
"title": "Source"
}
},
"title": "Source",
"type": "object"
},
"SpanReadResponse": {
"description": "Response model for a single span, with nested children.\n\nSerializes to camelCase JSON to match the frontend API contract.",
"properties": {
"children": {
"items": {
"$ref": "#/components/schemas/SpanReadResponse"
},
"title": "Children",
"type": "array"
},
"endTime": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Endtime"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"inputs": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Inputs"
},
"latencyMs": {
"title": "Latencyms",
"type": "integer"
},
"modelName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Modelname"
},
"name": {
"title": "Name",
"type": "string"
},
"outputs": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Outputs"
},
"startTime": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Starttime"
},
"status": {
"$ref": "#/components/schemas/SpanStatus"
},
"tokenUsage": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Tokenusage"
},
"type": {
"$ref": "#/components/schemas/SpanType"
}
},
"required": [
"id",
"name",
"type",
"status",
"startTime",
"endTime",
"latencyMs",
"inputs",
"outputs",
"error",
"modelName",
"tokenUsage"
],
"title": "SpanReadResponse",
"type": "object"
},
"SpanStatus": {
"description": "OpenTelemetry status codes.\n\n- UNSET: Default status, span has not ended yet\n- OK: Span completed successfully\n- ERROR: Span completed with an error",
"enum": [
"unset",
"ok",
"error"
],
"title": "SpanStatus",
"type": "string"
},
"SpanType": {
"description": "Types of spans that can be recorded.",
"enum": [
"chain",
"llm",
"tool",
"retriever",
"embedding",
"parser",
"agent"
],
"title": "SpanType",
"type": "string"
},
"TextContent": {
"additionalProperties": true,
"type": "object"
},
"ToolContent": {
"additionalProperties": true,
"type": "object"
},
"TraceListResponse": {
"description": "Paginated list response for traces.",
"properties": {
"pages": {
"title": "Pages",
"type": "integer"
},
"total": {
"title": "Total",
"type": "integer"
},
"traces": {
"items": {
"$ref": "#/components/schemas/TraceSummaryRead"
},
"title": "Traces",
"type": "array"
}
},
"required": [
"traces",
"total",
"pages"
],
"title": "TraceListResponse",
"type": "object"
},
"TraceRead": {
"description": "Response model for a single trace with its hierarchical span tree.\n\nSerializes to camelCase JSON to match the frontend API contract.",
"properties": {
"endTime": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Endtime"
},
"flowId": {
"format": "uuid",
"title": "Flowid",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"input": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Input"
},
"name": {
"title": "Name",
"type": "string"
},
"output": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Output"
},
"sessionId": {
"title": "Sessionid",
"type": "string"
},
"spans": {
"items": {
"$ref": "#/components/schemas/SpanReadResponse"
},
"title": "Spans",
"type": "array"
},
"startTime": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Starttime"
},
"status": {
"$ref": "#/components/schemas/SpanStatus"
},
"totalLatencyMs": {
"title": "Totallatencyms",
"type": "integer"
},
"totalTokens": {
"title": "Totaltokens",
"type": "integer"
}
},
"required": [
"id",
"name",
"status",
"startTime",
"endTime",
"totalLatencyMs",
"totalTokens",
"flowId",
"sessionId"
],
"title": "TraceRead",
"type": "object"
},
"TraceSummaryRead": {
"description": "Lightweight trace model for list endpoint.\n\nSerializes to camelCase JSON to match the frontend API contract.",
"properties": {
"flowId": {
"format": "uuid",
"title": "Flowid",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"input": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Input"
},
"name": {
"title": "Name",
"type": "string"
},
"output": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Output"
},
"sessionId": {
"title": "Sessionid",
"type": "string"
},
"startTime": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Starttime"
},
"status": {
"$ref": "#/components/schemas/SpanStatus"
},
"totalLatencyMs": {
"title": "Totallatencyms",
"type": "integer"
},
"totalTokens": {
"title": "Totaltokens",
"type": "integer"
}
},
"required": [
"id",
"name",
"status",
"startTime",
"totalLatencyMs",
"totalTokens",
"flowId",
"sessionId"
],
"title": "TraceSummaryRead",
"type": "object"
},
"TransactionLogsResponse": {
"description": "Transaction response model for logs view - excludes error and flow_id fields.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"inputs": {
"additionalProperties": true,
"title": "Inputs",
"type": "object"
},
"outputs": {
"additionalProperties": true,
"title": "Outputs",
"type": "object"
},
"status": {
"title": "Status",
"type": "string"
},
"target_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Target Id"
},
"timestamp": {
"format": "date-time",
"title": "Timestamp",
"type": "string"
},
"vertex_id": {
"title": "Vertex Id",
"type": "string"
}
},
"required": [
"id",
"vertex_id",
"status"
],
"title": "TransactionLogsResponse",
"type": "object"
},
"Tweaks": {
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"type": "object"
}
]
},
"description": "A dictionary of tweaks to adjust the flow's execution. Allows customizing flow behavior dynamically. All tweaks are overridden by the input values.",
"examples": [
{
"Component Name": {
"parameter_name": "value"
},
"component_id": {
"parameter_name": "value"
},
"parameter_name": "value"
}
],
"title": "Tweaks",
"type": "object"
},
"Usage": {
"description": "Token usage information from LLM responses.",
"properties": {
"input_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Input Tokens"
},
"output_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Output Tokens"
},
"total_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Total Tokens"
}
},
"title": "Usage",
"type": "object"
},
"UserCreate": {
"properties": {
"optins": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": {
"dialog_dismissed": false,
"discord_clicked": false,
"github_starred": false
},
"title": "Optins"
},
"password": {
"title": "Password",
"type": "string"
},
"username": {
"title": "Username",
"type": "string"
}
},
"required": [
"username",
"password"
],
"title": "UserCreate",
"type": "object"
},
"UserRead": {
"properties": {
"create_at": {
"format": "date-time",
"title": "Create At",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"is_active": {
"title": "Is Active",
"type": "boolean"
},
"is_superuser": {
"title": "Is Superuser",
"type": "boolean"
},
"last_login_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Login At"
},
"optins": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Optins"
},
"profile_image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Profile Image"
},
"store_api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Store Api Key"
},
"updated_at": {
"format": "date-time",
"title": "Updated At",
"type": "string"
},
"username": {
"title": "Username",
"type": "string"
}
},
"required": [
"username",
"profile_image",
"store_api_key",
"is_active",
"is_superuser",
"create_at",
"updated_at",
"last_login_at"
],
"title": "UserRead",
"type": "object"
},
"UserUpdate": {
"properties": {
"is_active": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Active"
},
"is_superuser": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Superuser"
},
"last_login_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Login At"
},
"optins": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Optins"
},
"password": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Password"
},
"profile_image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Profile Image"
},
"username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Username"
}
},
"title": "UserUpdate",
"type": "object"
},
"UsersResponse": {
"properties": {
"total_count": {
"title": "Total Count",
"type": "integer"
},
"users": {
"items": {
"$ref": "#/components/schemas/UserRead"
},
"title": "Users",
"type": "array"
}
},
"required": [
"total_count",
"users"
],
"title": "UsersResponse",
"type": "object"
},
"ValidationError": {
"properties": {
"ctx": {
"title": "Context",
"type": "object"
},
"input": {
"title": "Input"
},
"loc": {
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"title": "Location",
"type": "array"
},
"msg": {
"title": "Message",
"type": "string"
},
"type": {
"title": "Error Type",
"type": "string"
}
},
"required": [
"loc",
"msg",
"type"
],
"title": "ValidationError",
"type": "object"
},
"VertexBuildMapModel": {
"properties": {
"vertex_builds": {
"additionalProperties": {
"items": {
"$ref": "#/components/schemas/VertexBuildTable"
},
"type": "array"
},
"title": "Vertex Builds",
"type": "object"
}
},
"required": [
"vertex_builds"
],
"title": "VertexBuildMapModel",
"type": "object"
},
"VertexBuildTable": {
"properties": {
"artifacts": {
"additionalProperties": true,
"title": "Artifacts",
"type": "object"
},
"build_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Build Id"
},
"data": {
"additionalProperties": true,
"title": "Data",
"type": "object"
},
"flow_id": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
},
"id": {
"title": "Id",
"type": "string"
},
"job_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Id"
},
"params": {
"title": "Params",
"type": "string"
},
"timestamp": {
"format": "date-time",
"title": "Timestamp",
"type": "string"
},
"valid": {
"title": "Valid",
"type": "boolean"
}
},
"required": [
"id",
"valid",
"flow_id"
],
"title": "VertexBuildTable",
"type": "object"
},
"ViewPort": {
"properties": {
"x": {
"title": "X",
"type": "number"
},
"y": {
"title": "Y",
"type": "number"
},
"zoom": {
"title": "Zoom",
"type": "number"
}
},
"required": [
"x",
"y",
"zoom"
],
"title": "ViewPort",
"type": "object"
},
"WorkflowExecutionRequest": {
"additionalProperties": false,
"description": "Request schema for workflow execution.",
"examples": [
{
"background": false,
"flow_id": "flow_67ccd2be17f0819081ff3bb2cf6508e60bb6a6b452d3795b",
"inputs": {
"ChatInput-abc.input_value": "Hello, how can you help me today?",
"ChatInput-abc.session_id": "session-123",
"LLM-xyz.max_tokens": 100,
"LLM-xyz.temperature": 0.7,
"OpenSearch-def.opensearch_url": "https://opensearch:9200"
},
"stream": false
},
{
"background": true,
"flow_id": "flow_67ccd2be17f0819081ff3bb2cf6508e60bb6a6b452d3795b",
"inputs": {
"ChatInput-abc.input_value": "Process this in the background"
},
"stream": false
},
{
"background": false,
"flow_id": "flow_67ccd2be17f0819081ff3bb2cf6508e60bb6a6b452d3795b",
"inputs": {
"ChatInput-abc.input_value": "Stream this conversation"
},
"stream": true
}
],
"properties": {
"background": {
"default": false,
"title": "Background",
"type": "boolean"
},
"flow_id": {
"title": "Flow Id",
"type": "string"
},
"inputs": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"description": "Component-specific inputs in flat format: 'component_id.param_name': value",
"title": "Inputs"
},
"stream": {
"default": false,
"title": "Stream",
"type": "boolean"
}
},
"required": [
"flow_id"
],
"title": "WorkflowExecutionRequest",
"type": "object"
},
"WorkflowStopRequest": {
"description": "Request schema for stopping workflow.",
"properties": {
"job_id": {
"anyOf": [
{
"type": "string"
},
{
"format": "uuid",
"type": "string"
}
],
"title": "Job Id"
}
},
"required": [
"job_id"
],
"title": "WorkflowStopRequest",
"type": "object"
},
"WorkflowStopResponse": {
"description": "Response schema for stopping workflow.",
"properties": {
"job_id": {
"anyOf": [
{
"type": "string"
},
{
"format": "uuid",
"type": "string"
}
],
"title": "Job Id"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Message"
}
},
"required": [
"job_id"
],
"title": "WorkflowStopResponse",
"type": "object"
},
"langflow__api__schemas__UploadFileResponse": {
"description": "File upload response schema.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"path": {
"title": "Path",
"type": "string"
},
"provider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Provider"
},
"size": {
"title": "Size",
"type": "integer"
}
},
"required": [
"id",
"name",
"path",
"size"
],
"title": "UploadFileResponse",
"type": "object"
},
"langflow__api__v1__schemas__UploadFileResponse": {
"description": "Upload file response schema.",
"properties": {
"file_path": {
"title": "File Path",
"type": "string"
},
"flowId": {
"title": "Flowid",
"type": "string"
}
},
"required": [
"flowId",
"file_path"
],
"title": "UploadFileResponse",
"type": "object"
},
"langflow__services__database__models__file__model__File": {
"properties": {
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"path": {
"title": "Path",
"type": "string"
},
"provider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Provider"
},
"size": {
"title": "Size",
"type": "integer"
},
"updated_at": {
"format": "date-time",
"title": "Updated At",
"type": "string"
},
"user_id": {
"format": "uuid",
"title": "User Id",
"type": "string"
}
},
"required": [
"user_id",
"name",
"path",
"size"
],
"title": "File",
"type": "object"
},
"lfx__utils__schemas__File": {
"description": "File schema.",
"properties": {
"name": {
"title": "Name",
"type": "string"
},
"path": {
"title": "Path",
"type": "string"
},
"type": {
"title": "Type",
"type": "string"
}
},
"required": [
"path",
"name",
"type"
],
"title": "File",
"type": "object"
}
},
"securitySchemes": {
"API key header": {
"in": "header",
"name": "x-api-key",
"type": "apiKey"
},
"API key query": {
"in": "query",
"name": "x-api-key",
"type": "apiKey"
},
"OAuth2PasswordBearerCookie": {
"flows": {
"password": {
"scopes": {},
"tokenUrl": "api/v1/login"
}
},
"type": "oauth2"
}
}
},
"info": {
"title": "Langflow",
"version": "1.9.0"
},
"openapi": "3.1.0",
"paths": {
"/api/v1/all": {
"get": {
"description": "Retrieve all component types with compression for better performance.
Returns a compressed response containing all available component types.",
"operationId": "get_all_api_v1_all_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get All",
"tags": [
"Base"
]
}
},
"/api/v1/build/{flow_id}/flow": {
"post": {
"description": "Build and process a flow, returning a job ID for event polling.
This endpoint requires authentication through the CurrentActiveUser dependency.
For public flows that don't require authentication, use the /build_public_tmp/flow_id/flow endpoint.
Args:
flow_id: UUID of the flow to build
background_tasks: Background tasks manager
inputs: Optional input values for the flow
data: Optional flow data
files: Optional files to include
stop_component_id: Optional ID of component to stop at
start_component_id: Optional ID of component to start from
log_builds: Whether to log the build process
current_user: The authenticated user
queue_service: Queue service for job management
flow_name: Optional name for the flow
event_delivery: Optional event delivery type - default is streaming
Returns:
Dict with job_id that can be used to poll for build status",
"operationId": "build_flow_api_v1_build__flow_id__flow_post",
"parameters": [
{
"in": "path",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
},
{
"in": "query",
"name": "stop_component_id",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Stop Component Id"
}
},
{
"in": "query",
"name": "start_component_id",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Start Component Id"
}
},
{
"in": "query",
"name": "log_builds",
"required": false,
"schema": {
"default": true,
"title": "Log Builds",
"type": "boolean"
}
},
{
"in": "query",
"name": "flow_name",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Flow Name"
}
},
{
"in": "query",
"name": "event_delivery",
"required": false,
"schema": {
"$ref": "#/components/schemas/EventDeliveryType",
"default": "polling"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Body_build_flow_api_v1_build__flow_id__flow_post"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Build Flow",
"tags": [
"Chat"
]
}
},
"/api/v1/build/{job_id}/cancel": {
"post": {
"description": "Cancel a specific build job.
Requires authentication and ownership verification to prevent a user from
aborting another user's running build (DoS via job cancellation).
Jobs with no registered owner (build_public_tmp) are accessible to any
authenticated user, consistent with get_build_events.",
"operationId": "cancel_build_api_v1_build__job_id__cancel_post",
"parameters": [
{
"in": "path",
"name": "job_id",
"required": true,
"schema": {
"title": "Job Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CancelFlowResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Cancel Build",
"tags": [
"Chat"
]
}
},
"/api/v1/build/{job_id}/events": {
"get": {
"description": "Get events for a specific build job.
Requires authentication and ownership verification. A job owner is registered
when build_flow is called; if a registered owner does not match the requesting
user the endpoint returns 404 to avoid leaking job existence.
Jobs started via build_public_tmp have no registered owner and remain accessible
to any authenticated user.",
"operationId": "get_build_events_api_v1_build__job_id__events_get",
"parameters": [
{
"in": "path",
"name": "job_id",
"required": true,
"schema": {
"title": "Job Id",
"type": "string"
}
},
{
"in": "query",
"name": "event_delivery",
"required": false,
"schema": {
"$ref": "#/components/schemas/EventDeliveryType",
"default": "streaming"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get Build Events",
"tags": [
"Chat"
]
}
},
"/api/v1/build_public_tmp/{flow_id}/flow": {
"post": {
"description": "Build a public flow without requiring authentication.
This endpoint is specifically for public flows that don't require authentication.
It uses a client_id cookie to create a deterministic flow ID for tracking purposes.
Security Note:
- The 'data' parameter is NOT accepted to prevent flow definition tampering
- Public flows must execute the stored flow definition only
- The flow definition is always loaded from the database
The endpoint:
1. Verifies the requested flow is marked as public in the database
2. Creates a deterministic UUID based on client_id and flow_id
3. Uses the flow owner's permissions to build the flow
4. Always loads the flow definition from the database
Requirements:
- The flow must be marked as PUBLIC in the database
- The request must include a client_id cookie
Args:
flow_id: UUID of the public flow to build
background_tasks: Background tasks manager
inputs: Optional input values for the flow
files: Optional files to include
stop_component_id: Optional ID of component to stop at
start_component_id: Optional ID of component to start from
log_builds: Whether to log the build process
flow_name: Optional name for the flow
request: FastAPI request object (needed for cookie access)
queue_service: Queue service for job management
authenticated_user: Optional authenticated user (resolved from cookie/token if present)
event_delivery: Optional event delivery type - default is streaming
Returns:
Dict with job_id that can be used to poll for build status",
"operationId": "build_public_tmp_api_v1_build_public_tmp__flow_id__flow_post",
"parameters": [
{
"in": "path",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
},
{
"in": "query",
"name": "stop_component_id",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Stop Component Id"
}
},
{
"in": "query",
"name": "start_component_id",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Start Component Id"
}
},
{
"in": "query",
"name": "log_builds",
"required": false,
"schema": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": true,
"title": "Log Builds"
}
},
{
"in": "query",
"name": "flow_name",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Flow Name"
}
},
{
"in": "query",
"name": "event_delivery",
"required": false,
"schema": {
"$ref": "#/components/schemas/EventDeliveryType",
"default": "polling"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Body_build_public_tmp_api_v1_build_public_tmp__flow_id__flow_post"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Build Public Tmp",
"tags": [
"Chat"
]
}
},
"/api/v1/build_public_tmp/{job_id}/cancel": {
"post": {
"description": "Cancel a public flow build job.
This endpoint does not require authentication, matching the public build endpoint.
It is used by the shareable playground to cancel builds.",
"operationId": "cancel_build_public_api_v1_build_public_tmp__job_id__cancel_post",
"parameters": [
{
"in": "path",
"name": "job_id",
"required": true,
"schema": {
"title": "Job Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CancelFlowResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Cancel Build Public",
"tags": [
"Chat"
]
}
},
"/api/v1/build_public_tmp/{job_id}/events": {
"get": {
"description": "Get events for a public flow build job.
This endpoint does not require authentication, matching the public build endpoint.
It is used by the shareable playground to consume build events.",
"operationId": "get_build_events_public_api_v1_build_public_tmp__job_id__events_get",
"parameters": [
{
"in": "path",
"name": "job_id",
"required": true,
"schema": {
"title": "Job Id",
"type": "string"
}
},
{
"in": "query",
"name": "event_delivery",
"required": false,
"schema": {
"$ref": "#/components/schemas/EventDeliveryType",
"default": "streaming"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Build Events Public",
"tags": [
"Chat"
]
}
},
"/api/v1/config": {
"get": {
"description": "Retrieve application configuration settings.
Returns different configuration based on authentication status:
- Authenticated users: Full ConfigResponse with all settings
- Unauthenticated users: PublicConfigResponse with limited, safe-to-expose settings
Args:
user: The authenticated user, or None if unauthenticated.
Returns:
ConfigResponse | PublicConfigResponse: Configuration settings appropriate for the user's auth status.
Raises:
HTTPException: If an error occurs while retrieving the configuration.",
"operationId": "get_config_api_v1_config_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"anyOf": [
{
"$ref": "#/components/schemas/ConfigResponse"
},
{
"$ref": "#/components/schemas/PublicConfigResponse"
}
],
"title": "Response Get Config Api V1 Config Get"
}
}
},
"description": "Successful Response"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get Config",
"tags": [
"Base"
]
}
},
"/api/v1/files/delete/{flow_id}/{file_name}": {
"delete": {
"operationId": "delete_file_api_v1_files_delete__flow_id___file_name__delete",
"parameters": [
{
"in": "path",
"name": "file_name",
"required": true,
"schema": {
"title": "File Name",
"type": "string"
}
},
{
"in": "path",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete File",
"tags": [
"Files"
]
}
},
"/api/v1/files/download/{flow_id}/{file_name}": {
"get": {
"operationId": "download_file_api_v1_files_download__flow_id___file_name__get",
"parameters": [
{
"in": "path",
"name": "file_name",
"required": true,
"schema": {
"title": "File Name",
"type": "string"
}
},
{
"in": "path",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Download File",
"tags": [
"Files"
]
}
},
"/api/v1/files/images/{flow_id}/{file_name}": {
"get": {
"description": "Download image from storage for browser rendering.",
"operationId": "download_image_api_v1_files_images__flow_id___file_name__get",
"parameters": [
{
"in": "path",
"name": "file_name",
"required": true,
"schema": {
"title": "File Name",
"type": "string"
}
},
{
"in": "path",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Download Image",
"tags": [
"Files"
]
}
},
"/api/v1/files/list/{flow_id}": {
"get": {
"operationId": "list_files_api_v1_files_list__flow_id__get",
"parameters": [
{
"in": "path",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "List Files",
"tags": [
"Files"
]
}
},
"/api/v1/files/profile_pictures/list": {
"get": {
"description": "List profile pictures from local filesystem.
Profile pictures are first looked up in config_dir/profile_pictures/,
then fallback to the package's bundled profile_pictures directory.",
"operationId": "list_profile_pictures_api_v1_files_profile_pictures_list_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
}
},
"summary": "List Profile Pictures",
"tags": [
"Files"
]
}
},
"/api/v1/files/profile_pictures/{folder_name}/{file_name}": {
"get": {
"description": "Download profile picture from local filesystem.
Profile pictures are first looked up in config_dir/profile_pictures/,
then fallback to the package's bundled profile_pictures directory.",
"operationId": "download_profile_picture_api_v1_files_profile_pictures__folder_name___file_name__get",
"parameters": [
{
"in": "path",
"name": "folder_name",
"required": true,
"schema": {
"title": "Folder Name",
"type": "string"
}
},
{
"in": "path",
"name": "file_name",
"required": true,
"schema": {
"title": "File Name",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Download Profile Picture",
"tags": [
"Files"
]
}
},
"/api/v1/files/upload/{flow_id}": {
"post": {
"operationId": "upload_file_api_v1_files_upload__flow_id__post",
"parameters": [
{
"in": "path",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_upload_file_api_v1_files_upload__flow_id__post"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/langflow__api__v1__schemas__UploadFileResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Upload File",
"tags": [
"Files"
]
}
},
"/api/v1/flows/": {
"delete": {
"description": "Delete multiple flows by their IDs.",
"operationId": "delete_multiple_flows_api_v1_flows__delete",
"requestBody": {
"content": {
"application/json": {
"schema": {
"items": {
"format": "uuid",
"type": "string"
},
"title": "Flow Ids",
"type": "array"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete Multiple Flows",
"tags": [
"Flows"
]
},
"get": {
"description": "Retrieve a list of flows with optional pagination, filtering, and header-only mode.",
"operationId": "read_flows_api_v1_flows__get",
"parameters": [
{
"in": "query",
"name": "remove_example_flows",
"required": false,
"schema": {
"default": false,
"title": "Remove Example Flows",
"type": "boolean"
}
},
{
"in": "query",
"name": "components_only",
"required": false,
"schema": {
"default": false,
"title": "Components Only",
"type": "boolean"
}
},
{
"in": "query",
"name": "get_all",
"required": false,
"schema": {
"default": true,
"title": "Get All",
"type": "boolean"
}
},
{
"in": "query",
"name": "folder_id",
"required": false,
"schema": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Folder Id"
}
},
{
"in": "query",
"name": "header_flows",
"required": false,
"schema": {
"default": false,
"title": "Header Flows",
"type": "boolean"
}
},
{
"in": "query",
"name": "page",
"required": false,
"schema": {
"default": 1,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
{
"in": "query",
"name": "size",
"required": false,
"schema": {
"default": 50,
"maximum": 100,
"minimum": 1,
"title": "Size",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/FlowRead"
},
"type": "array"
},
{
"$ref": "#/components/schemas/Page_FlowRead_"
},
{
"items": {
"$ref": "#/components/schemas/FlowHeader"
},
"type": "array"
}
],
"title": "Response Read Flows Api V1 Flows Get"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Read Flows",
"tags": [
"Flows"
]
},
"post": {
"operationId": "create_flow_api_v1_flows__post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FlowCreate"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FlowRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Create Flow",
"tags": [
"Flows"
]
}
},
"/api/v1/flows/basic_examples/": {
"get": {
"description": "Retrieve a list of basic example flows.",
"operationId": "read_basic_examples_api_v1_flows_basic_examples__get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/FlowRead"
},
"title": "Response Read Basic Examples Api V1 Flows Basic Examples Get",
"type": "array"
}
}
},
"description": "Successful Response"
}
},
"summary": "Read Basic Examples",
"tags": [
"Flows"
]
}
},
"/api/v1/flows/batch/": {
"post": {
"description": "Create multiple new flows.",
"operationId": "create_flows_api_v1_flows_batch__post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FlowListCreate"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/FlowRead"
},
"title": "Response Create Flows Api V1 Flows Batch Post",
"type": "array"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Create Flows",
"tags": [
"Flows"
]
}
},
"/api/v1/flows/download/": {
"post": {
"description": "Download all flows as a zip file.",
"operationId": "download_multiple_file_api_v1_flows_download__post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"items": {
"format": "uuid",
"type": "string"
},
"title": "Flow Ids",
"type": "array"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Download Multiple File",
"tags": [
"Flows"
]
}
},
"/api/v1/flows/public_flow/{flow_id}": {
"get": {
"description": "Read a public flow.",
"operationId": "read_public_flow_api_v1_flows_public_flow__flow_id__get",
"parameters": [
{
"in": "path",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FlowRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Read Public Flow",
"tags": [
"Flows"
]
}
},
"/api/v1/flows/upload/": {
"post": {
"description": "Upload flows from a JSON or ZIP file (upsert semantics for flows with stable IDs).",
"operationId": "upload_file_api_v1_flows_upload__post",
"parameters": [
{
"in": "query",
"name": "folder_id",
"required": false,
"schema": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Folder Id"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_upload_file_api_v1_flows_upload__post"
}
}
}
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/FlowRead"
},
"title": "Response Upload File Api V1 Flows Upload Post",
"type": "array"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Upload File",
"tags": [
"Flows"
]
}
},
"/api/v1/flows/{flow_id}": {
"delete": {
"description": "Delete a flow.",
"operationId": "delete_flow_api_v1_flows__flow_id__delete",
"parameters": [
{
"in": "path",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete Flow",
"tags": [
"Flows"
]
},
"get": {
"description": "Read a flow.",
"operationId": "read_flow_api_v1_flows__flow_id__get",
"parameters": [
{
"in": "path",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FlowRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Read Flow",
"tags": [
"Flows"
]
},
"patch": {
"description": "Update a flow.",
"operationId": "update_flow_api_v1_flows__flow_id__patch",
"parameters": [
{
"in": "path",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FlowUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FlowRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Update Flow",
"tags": [
"Flows"
]
},
"put": {
"description": "Create or update a flow with a specific ID (upsert).
Returns 201 for creation, 200 for update. Returns 404 if owned by another user.",
"operationId": "upsert_flow_api_v1_flows__flow_id__put",
"parameters": [
{
"in": "path",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FlowCreate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FlowRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Upsert Flow",
"tags": [
"Flows"
]
}
},
"/api/v1/flows/{flow_id}/events": {
"get": {
"operationId": "get_flow_events_api_v1_flows__flow_id__events_get",
"parameters": [
{
"in": "path",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
},
{
"description": "UTC timestamp to get events after",
"in": "query",
"name": "since",
"required": false,
"schema": {
"default": 0.0,
"description": "UTC timestamp to get events after",
"title": "Since",
"type": "number"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FlowEventsResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get Flow Events",
"tags": [
"Flow Events"
]
},
"post": {
"description": "Append an event to a flow's event queue.",
"operationId": "create_flow_event_api_v1_flows__flow_id__events_post",
"parameters": [
{
"in": "path",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FlowEventCreate"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FlowEventResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Create Flow Event",
"tags": [
"Flow Events"
]
}
},
"/api/v1/mcp/project/{project_id}": {
"get": {
"description": "List project MCP tools.",
"operationId": "list_project_tools_api_v1_mcp_project__project_id__get",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "query",
"name": "mcp_enabled",
"required": false,
"schema": {
"default": true,
"title": "Mcp Enabled",
"type": "boolean"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "List Project Tools",
"tags": [
"mcp_projects"
]
},
"patch": {
"description": "Update the MCP settings of all flows in a project and project-level auth settings.
On MCP Composer failure, this endpoint should return with a 200 status code and an error message in
the body of the response to display to the user.",
"operationId": "update_project_mcp_settings_api_v1_mcp_project__project_id__patch",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MCPProjectUpdateRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Update Project Mcp Settings",
"tags": [
"mcp_projects"
]
}
},
"/api/v1/mcp/project/{project_id}/composer-url": {
"get": {
"description": "Get the MCP Composer URL for a specific project.
On failure, this endpoint should return with a 200 status code and an error message in
the body of the response to display to the user.",
"operationId": "get_project_composer_url_api_v1_mcp_project__project_id__composer_url_get",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ComposerUrlResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get Project Composer Url",
"tags": [
"mcp_projects"
]
}
},
"/api/v1/mcp/project/{project_id}/install": {
"post": {
"description": "Install MCP server configuration for Cursor, Windsurf, or Claude.",
"operationId": "install_mcp_config_api_v1_mcp_project__project_id__install_post",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MCPInstallRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Install Mcp Config",
"tags": [
"mcp_projects"
]
}
},
"/api/v1/mcp/project/{project_id}/installed": {
"get": {
"description": "Check if MCP server configuration is installed for this project in Cursor, Windsurf, or Claude.",
"operationId": "check_installed_mcp_servers_api_v1_mcp_project__project_id__installed_get",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Check Installed Mcp Servers",
"tags": [
"mcp_projects"
]
}
},
"/api/v1/monitor/builds": {
"delete": {
"operationId": "delete_vertex_builds_api_v1_monitor_builds_delete",
"parameters": [
{
"in": "query",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
}
],
"responses": {
"204": {
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete Vertex Builds",
"tags": [
"Monitor"
]
},
"get": {
"operationId": "get_vertex_builds_api_v1_monitor_builds_get",
"parameters": [
{
"in": "query",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/VertexBuildMapModel"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get Vertex Builds",
"tags": [
"Monitor"
]
}
},
"/api/v1/monitor/messages": {
"delete": {
"operationId": "delete_messages_api_v1_monitor_messages_delete",
"requestBody": {
"content": {
"application/json": {
"schema": {
"items": {
"format": "uuid",
"type": "string"
},
"title": "Message Ids",
"type": "array"
}
}
},
"required": true
},
"responses": {
"204": {
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete Messages",
"tags": [
"Monitor"
]
},
"get": {
"operationId": "get_messages_api_v1_monitor_messages_get",
"parameters": [
{
"in": "query",
"name": "flow_id",
"required": false,
"schema": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Flow Id"
}
},
{
"in": "query",
"name": "session_id",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Session Id"
}
},
{
"in": "query",
"name": "sender",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Sender"
}
},
{
"in": "query",
"name": "sender_name",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Sender Name"
}
},
{
"in": "query",
"name": "order_by",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "timestamp",
"title": "Order By"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/MessageResponse"
},
"title": "Response Get Messages Api V1 Monitor Messages Get",
"type": "array"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get Messages",
"tags": [
"Monitor"
]
}
},
"/api/v1/monitor/messages/session/{old_session_id}": {
"patch": {
"operationId": "update_session_id_api_v1_monitor_messages_session__old_session_id__patch",
"parameters": [
{
"in": "path",
"name": "old_session_id",
"required": true,
"schema": {
"title": "Old Session Id",
"type": "string"
}
},
{
"description": "The new session ID to update to",
"in": "query",
"name": "new_session_id",
"required": true,
"schema": {
"description": "The new session ID to update to",
"title": "New Session Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/MessageResponse"
},
"title": "Response Update Session Id Api V1 Monitor Messages Session Old Session Id Patch",
"type": "array"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Update Session Id",
"tags": [
"Monitor"
]
}
},
"/api/v1/monitor/messages/session/{session_id}": {
"delete": {
"description": "Delete messages for a single session.
Only deletes messages from sessions belonging to flows owned by the current user.",
"operationId": "delete_messages_session_api_v1_monitor_messages_session__session_id__delete",
"parameters": [
{
"in": "path",
"name": "session_id",
"required": true,
"schema": {
"title": "Session Id",
"type": "string"
}
}
],
"responses": {
"204": {
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete Messages Session",
"tags": [
"Monitor"
]
}
},
"/api/v1/monitor/messages/sessions": {
"delete": {
"description": "Bulk delete messages for multiple sessions at once.
Only deletes messages from sessions belonging to flows owned by the current user.
Args:
session_ids: List of session IDs to delete (max 500)
session: Database session
current_user: Current authenticated user
Returns:
Confirmation message with count of deleted sessions
Raises:
HTTPException: 400 if session_ids list exceeds 500 items
HTTPException: 500 if database operation fails",
"operationId": "delete_messages_sessions_api_v1_monitor_messages_sessions_delete",
"requestBody": {
"content": {
"application/json": {
"schema": {
"items": {
"type": "string"
},
"title": "Session Ids",
"type": "array"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete Messages Sessions",
"tags": [
"Monitor"
]
},
"get": {
"operationId": "get_message_sessions_api_v1_monitor_messages_sessions_get",
"parameters": [
{
"in": "query",
"name": "flow_id",
"required": false,
"schema": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Flow Id"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"items": {
"type": "string"
},
"title": "Response Get Message Sessions Api V1 Monitor Messages Sessions Get",
"type": "array"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get Message Sessions",
"tags": [
"Monitor"
]
}
},
"/api/v1/monitor/messages/shared": {
"get": {
"description": "Get messages for a shared/public flow, scoped to the authenticated user.
Uses a deterministic virtual flow_id derived from the user's ID and the
original flow ID. Only messages stored under this virtual flow_id are returned.",
"operationId": "get_shared_messages_api_v1_monitor_messages_shared_get",
"parameters": [
{
"description": "The original public flow ID",
"in": "query",
"name": "source_flow_id",
"required": true,
"schema": {
"description": "The original public flow ID",
"format": "uuid",
"title": "Source Flow Id",
"type": "string"
}
},
{
"in": "query",
"name": "session_id",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Session Id"
}
},
{
"in": "query",
"name": "order_by",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "timestamp",
"title": "Order By"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/MessageResponse"
},
"title": "Response Get Shared Messages Api V1 Monitor Messages Shared Get",
"type": "array"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get Shared Messages",
"tags": [
"Monitor"
]
}
},
"/api/v1/monitor/messages/shared/session/{old_session_id}": {
"patch": {
"description": "Rename a session on a shared/public flow, scoped to the authenticated user.",
"operationId": "rename_shared_session_api_v1_monitor_messages_shared_session__old_session_id__patch",
"parameters": [
{
"in": "path",
"name": "old_session_id",
"required": true,
"schema": {
"title": "Old Session Id",
"type": "string"
}
},
{
"description": "The new session ID",
"in": "query",
"name": "new_session_id",
"required": true,
"schema": {
"description": "The new session ID",
"title": "New Session Id",
"type": "string"
}
},
{
"description": "The original public flow ID",
"in": "query",
"name": "source_flow_id",
"required": true,
"schema": {
"description": "The original public flow ID",
"format": "uuid",
"title": "Source Flow Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/MessageResponse"
},
"title": "Response Rename Shared Session Api V1 Monitor Messages Shared Session Old Session Id Patch",
"type": "array"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Rename Shared Session",
"tags": [
"Monitor"
]
}
},
"/api/v1/monitor/messages/shared/session/{session_id}": {
"delete": {
"description": "Delete messages for a session on a shared/public flow, scoped to the authenticated user.",
"operationId": "delete_shared_messages_session_api_v1_monitor_messages_shared_session__session_id__delete",
"parameters": [
{
"in": "path",
"name": "session_id",
"required": true,
"schema": {
"title": "Session Id",
"type": "string"
}
},
{
"description": "The original public flow ID",
"in": "query",
"name": "source_flow_id",
"required": true,
"schema": {
"description": "The original public flow ID",
"format": "uuid",
"title": "Source Flow Id",
"type": "string"
}
}
],
"responses": {
"204": {
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete Shared Messages Session",
"tags": [
"Monitor"
]
}
},
"/api/v1/monitor/messages/shared/sessions": {
"get": {
"description": "Get session IDs for a shared/public flow, scoped to the authenticated user.
Uses a deterministic virtual flow_id derived from the user's ID and the
original flow ID. Only messages stored under this virtual flow_id are returned.",
"operationId": "get_shared_message_sessions_api_v1_monitor_messages_shared_sessions_get",
"parameters": [
{
"description": "The original public flow ID",
"in": "query",
"name": "source_flow_id",
"required": true,
"schema": {
"description": "The original public flow ID",
"format": "uuid",
"title": "Source Flow Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"items": {
"type": "string"
},
"title": "Response Get Shared Message Sessions Api V1 Monitor Messages Shared Sessions Get",
"type": "array"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get Shared Message Sessions",
"tags": [
"Monitor"
]
}
},
"/api/v1/monitor/messages/shared/{message_id}": {
"put": {
"description": "Update a message on a shared/public flow, scoped to the authenticated user.",
"operationId": "update_shared_message_api_v1_monitor_messages_shared__message_id__put",
"parameters": [
{
"in": "path",
"name": "message_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Message Id",
"type": "string"
}
},
{
"description": "The original public flow ID",
"in": "query",
"name": "source_flow_id",
"required": true,
"schema": {
"description": "The original public flow ID",
"format": "uuid",
"title": "Source Flow Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MessageUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MessageRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Update Shared Message",
"tags": [
"Monitor"
]
}
},
"/api/v1/monitor/messages/{message_id}": {
"put": {
"operationId": "update_message_api_v1_monitor_messages__message_id__put",
"parameters": [
{
"in": "path",
"name": "message_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Message Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MessageUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MessageRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Update Message",
"tags": [
"Monitor"
]
}
},
"/api/v1/monitor/traces": {
"delete": {
"description": "Delete all traces for a flow.
Args:
flow_id: The ID of the flow whose traces should be deleted.
current_user: The authenticated user (required for authorization).",
"operationId": "delete_traces_by_flow_api_v1_monitor_traces_delete",
"parameters": [
{
"in": "query",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
}
],
"responses": {
"204": {
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete Traces By Flow",
"tags": [
"Traces"
]
},
"get": {
"description": "Get list of traces for a flow.
Args:
current_user: Authenticated user (required for authorization)
flow_id: Filter by flow ID
session_id: Filter by session ID
status: Filter by trace status
query: Search query for trace name/id/session id
start_time: Filter traces starting on/after this time (ISO)
end_time: Filter traces starting on/before this time (ISO)
page: Page number (1-based)
size: Page size
Returns:
List of traces",
"operationId": "get_traces_api_v1_monitor_traces_get",
"parameters": [
{
"in": "query",
"name": "flow_id",
"required": false,
"schema": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Flow Id"
}
},
{
"in": "query",
"name": "session_id",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Session Id"
}
},
{
"in": "query",
"name": "status",
"required": false,
"schema": {
"anyOf": [
{
"$ref": "#/components/schemas/SpanStatus"
},
{
"type": "null"
}
],
"title": "Status"
}
},
{
"in": "query",
"name": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Query"
}
},
{
"in": "query",
"name": "start_time",
"required": false,
"schema": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Start Time"
}
},
{
"in": "query",
"name": "end_time",
"required": false,
"schema": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "End Time"
}
},
{
"in": "query",
"name": "page",
"required": false,
"schema": {
"default": 1,
"minimum": 0,
"title": "Page",
"type": "integer"
}
},
{
"in": "query",
"name": "size",
"required": false,
"schema": {
"default": 50,
"maximum": 200,
"minimum": 1,
"title": "Size",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TraceListResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get Traces",
"tags": [
"Traces"
]
}
},
"/api/v1/monitor/traces/{trace_id}": {
"delete": {
"description": "Delete a trace and all its spans.
Args:
trace_id: The ID of the trace to delete.
current_user: The authenticated user (required for authorization).",
"operationId": "delete_trace_api_v1_monitor_traces__trace_id__delete",
"parameters": [
{
"in": "path",
"name": "trace_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Trace Id",
"type": "string"
}
}
],
"responses": {
"204": {
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete Trace",
"tags": [
"Traces"
]
},
"get": {
"description": "Get a single trace with its hierarchical span tree.
Args:
trace_id: The ID of the trace to retrieve.
current_user: The authenticated user (required for authorization).
Returns:
TraceRead containing the trace and its hierarchical span tree.",
"operationId": "get_trace_api_v1_monitor_traces__trace_id__get",
"parameters": [
{
"in": "path",
"name": "trace_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Trace Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TraceRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get Trace",
"tags": [
"Traces"
]
}
},
"/api/v1/monitor/transactions": {
"get": {
"operationId": "get_transactions_api_v1_monitor_transactions_get",
"parameters": [
{
"in": "query",
"name": "flow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Flow Id",
"type": "string"
}
},
{
"description": "Page number",
"in": "query",
"name": "page",
"required": false,
"schema": {
"default": 1,
"description": "Page number",
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
{
"description": "Page size",
"in": "query",
"name": "size",
"required": false,
"schema": {
"default": 50,
"description": "Page size",
"maximum": 100,
"minimum": 1,
"title": "Size",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Page_TransactionLogsResponse_"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get Transactions",
"tags": [
"Monitor"
]
}
},
"/api/v1/projects/": {
"get": {
"operationId": "read_projects_api_v1_projects__get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/FolderRead"
},
"title": "Response Read Projects Api V1 Projects Get",
"type": "array"
}
}
},
"description": "Successful Response"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Read Projects",
"tags": [
"Projects"
]
},
"post": {
"operationId": "create_project_api_v1_projects__post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FolderCreate"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FolderRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Create Project",
"tags": [
"Projects"
]
}
},
"/api/v1/projects/download/{project_id}": {
"get": {
"description": "Download all flows from project as a zip file.",
"operationId": "download_file_api_v1_projects_download__project_id__get",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Download File",
"tags": [
"Projects"
]
}
},
"/api/v1/projects/upload/": {
"post": {
"description": "Upload flows from a file.
Accepts either a JSON file with project metadata (folder_name, folder_description, flows)
or a ZIP file containing individual flow JSON files (as produced by the download endpoint).",
"operationId": "upload_file_api_v1_projects_upload__post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_upload_file_api_v1_projects_upload__post"
}
}
}
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/FlowRead"
},
"title": "Response Upload File Api V1 Projects Upload Post",
"type": "array"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Upload File",
"tags": [
"Projects"
]
}
},
"/api/v1/projects/{project_id}": {
"delete": {
"operationId": "delete_project_api_v1_projects__project_id__delete",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"responses": {
"204": {
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete Project",
"tags": [
"Projects"
]
},
"get": {
"operationId": "read_project_api_v1_projects__project_id__get",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "query",
"name": "page",
"required": false,
"schema": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Page"
}
},
{
"in": "query",
"name": "size",
"required": false,
"schema": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Size"
}
},
{
"in": "query",
"name": "is_component",
"required": false,
"schema": {
"default": false,
"title": "Is Component",
"type": "boolean"
}
},
{
"in": "query",
"name": "is_flow",
"required": false,
"schema": {
"default": false,
"title": "Is Flow",
"type": "boolean"
}
},
{
"in": "query",
"name": "search",
"required": false,
"schema": {
"default": "",
"title": "Search",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"anyOf": [
{
"$ref": "#/components/schemas/FolderWithPaginatedFlows"
},
{
"$ref": "#/components/schemas/FolderReadWithFlows"
}
],
"title": "Response Read Project Api V1 Projects Project Id Get"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Read Project",
"tags": [
"Projects"
]
},
"patch": {
"operationId": "update_project_api_v1_projects__project_id__patch",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FolderUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FolderRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Update Project",
"tags": [
"Projects"
]
}
},
"/api/v1/responses": {
"post": {
"description": "Create a response using OpenAI Responses API format.
This endpoint accepts a flow_id in the model parameter and processes
the input through the specified Langflow flow.
Args:
request: OpenAI Responses API request with model (flow_id) and input
background_tasks: FastAPI background task manager
api_key_user: Authenticated user from API key
http_request: The incoming HTTP request
telemetry_service: Telemetry service for logging
Returns:
OpenAI-compatible response or streaming response
Raises:
HTTPException: For validation errors or flow execution issues",
"operationId": "create_response_api_v1_responses_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/OpenAIResponsesRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Create Response",
"tags": [
"OpenAI Responses API"
]
}
},
"/api/v1/run/advanced/{flow_id_or_name}": {
"post": {
"description": "Executes a specified flow by ID with optional input values, output selection, tweaks, and streaming capability.
This endpoint supports running flows with caching to enhance performance and efficiency.
### Parameters:
- `flow` (Flow): The flow object to be executed, resolved via dependency injection.
- `inputs` (List[InputValueRequest], optional): A list of inputs specifying the input values and components
for the flow. Each input can target specific components and provide custom values.
- `outputs` (List[str], optional): A list of output names to retrieve from the executed flow.
If not provided, all outputs are returned.
- `tweaks` (Optional[Tweaks], optional): A dictionary of tweaks to customize the flow execution.
The tweaks can be used to modify the flow's parameters and components.
Tweaks can be overridden by the input values.
- `stream` (bool, optional): Specifies whether the results should be streamed. Defaults to False.
- `session_id` (Union[None, str], optional): An optional session ID to utilize existing session data for the flow
execution.
- `api_key_user` (User): The user associated with the current API key. Automatically resolved from the API key.
### Returns:
A `RunResponse` object containing the selected outputs (or all if not specified) of the executed flow
and the session ID.
The structure of the response accommodates multiple inputs, providing a nested list of outputs for each input.
### Raises:
HTTPException: Indicates issues with finding the specified flow, invalid input formats, or internal errors during
flow execution.
### Example usage:
```json
POST /run/flow_id
x-api-key: YOUR_API_KEY
Payload:
{
\"inputs\": [
{\"components\": [\"component1\"], \"input_value\": \"value1\"},
{\"components\": [\"component3\"], \"input_value\": \"value2\"}
],
\"outputs\": [\"Component Name\", \"component_id\"],
\"tweaks\": {\"parameter_name\": \"value\", \"Component Name\": {\"parameter_name\": \"value\"}, \"component_id\": {\"parameter_name\": \"value\"}}
\"stream\": false
}
```
This endpoint facilitates complex flow executions with customized inputs, outputs, and configurations,
catering to diverse application requirements.",
"operationId": "experimental_run_flow_api_v1_run_advanced__flow_id_or_name__post",
"parameters": [
{
"in": "path",
"name": "flow_id_or_name",
"required": true,
"schema": {
"title": "Flow Id Or Name",
"type": "string"
}
},
{
"in": "query",
"name": "user_id",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "User Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Body_experimental_run_flow_api_v1_run_advanced__flow_id_or_name__post"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RunResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Experimental Run Flow",
"tags": [
"Base"
]
}
},
"/api/v1/run/{flow_id_or_name}": {
"post": {
"description": "Executes a specified flow by ID with support for streaming and telemetry (API key auth).
This endpoint executes a flow identified by ID or name, with options for streaming the response
and tracking execution metrics. It handles both streaming and non-streaming execution modes.
This endpoint uses API key authentication (Bearer token).
Args:
background_tasks (BackgroundTasks): FastAPI background task manager
flow (FlowRead | None): The flow to execute, loaded via dependency
input_request (SimplifiedAPIRequest | None): Input parameters for the flow
stream (bool): Whether to stream the response
api_key_user (UserRead): Authenticated user from API key
context (dict | None): Optional context to pass to the flow
http_request (Request): The incoming HTTP request for extracting global variables
Returns:
Union[StreamingResponse, RunResponse]: Either a streaming response for real-time results
or a RunResponse with the complete execution results
Raises:
HTTPException: For flow not found (404) or invalid input (400)
APIException: For internal execution errors (500)
Notes:
- Supports both streaming and non-streaming execution modes
- Tracks execution time and success/failure via telemetry
- Handles graceful client disconnection in streaming mode
- Provides detailed error handling with appropriate HTTP status codes
- Extracts global variables from HTTP headers with prefix X-LANGFLOW-GLOBAL-VAR-*
- Merges extracted variables with the context parameter as \"request_variables\"
- In streaming mode, uses EventManager to handle events:
- \"add_message\": New messages during execution
- \"token\": Individual tokens during streaming
- \"end\": Final execution result
- Authentication: Requires API key (Bearer token)",
"operationId": "simplified_run_flow_api_v1_run__flow_id_or_name__post",
"parameters": [
{
"in": "path",
"name": "flow_id_or_name",
"required": true,
"schema": {
"title": "Flow Id Or Name",
"type": "string"
}
},
{
"in": "query",
"name": "stream",
"required": false,
"schema": {
"default": false,
"title": "Stream",
"type": "boolean"
}
},
{
"in": "query",
"name": "user_id",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "User Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Body_simplified_run_flow_api_v1_run__flow_id_or_name__post"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Simplified Run Flow",
"tags": [
"Base"
]
}
},
"/api/v1/starter-projects/": {
"get": {
"description": "Get a list of starter projects.",
"operationId": "get_starter_projects_api_v1_starter_projects__get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/GraphDumpResponse"
},
"title": "Response Get Starter Projects Api V1 Starter Projects Get",
"type": "array"
}
}
},
"description": "Successful Response"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get Starter Projects",
"tags": [
"Flows"
]
}
},
"/api/v1/users/": {
"get": {
"description": "Retrieve a list of users from the database with pagination.",
"operationId": "read_all_users_api_v1_users__get",
"parameters": [
{
"in": "query",
"name": "skip",
"required": false,
"schema": {
"default": 0,
"title": "Skip",
"type": "integer"
}
},
{
"in": "query",
"name": "limit",
"required": false,
"schema": {
"default": 10,
"title": "Limit",
"type": "integer"
}
},
{
"in": "query",
"name": "search",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Search"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UsersResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Read All Users",
"tags": [
"Users"
]
},
"post": {
"description": "Add a new user to the database.
This endpoint allows public user registration (sign up).
User activation is controlled by the NEW_USER_IS_ACTIVE setting.",
"operationId": "add_user_api_v1_users__post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UserCreate"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UserRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Add User",
"tags": [
"Users"
]
}
},
"/api/v1/users/whoami": {
"get": {
"description": "Retrieve the current user's data.",
"operationId": "read_current_user_api_v1_users_whoami_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UserRead"
}
}
},
"description": "Successful Response"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Read Current User",
"tags": [
"Users"
]
}
},
"/api/v1/users/{user_id}": {
"delete": {
"description": "Delete a user from the database.",
"operationId": "delete_user_api_v1_users__user_id__delete",
"parameters": [
{
"in": "path",
"name": "user_id",
"required": true,
"schema": {
"format": "uuid",
"title": "User Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"additionalProperties": true,
"title": "Response Delete User Api V1 Users User Id Delete",
"type": "object"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete User",
"tags": [
"Users"
]
},
"patch": {
"description": "Update an existing user's data.",
"operationId": "patch_user_api_v1_users__user_id__patch",
"parameters": [
{
"in": "path",
"name": "user_id",
"required": true,
"schema": {
"format": "uuid",
"title": "User Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UserUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UserRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Patch User",
"tags": [
"Users"
]
}
},
"/api/v1/users/{user_id}/reset-password": {
"patch": {
"description": "Reset a user's password.",
"operationId": "reset_password_api_v1_users__user_id__reset_password_patch",
"parameters": [
{
"in": "path",
"name": "user_id",
"required": true,
"schema": {
"format": "uuid",
"title": "User Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UserUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UserRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Reset Password",
"tags": [
"Users"
]
}
},
"/api/v1/version": {
"get": {
"operationId": "get_version_api_v1_version_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
}
},
"summary": "Get Version",
"tags": [
"Base"
]
}
},
"/api/v1/webhook/{flow_id_or_name}": {
"post": {
"description": "Run a flow using a webhook request.
Args:
flow_id_or_name: The flow ID or endpoint name (used by dependency).
flow: The flow to be executed.
request: The incoming HTTP request.
Returns:
A dictionary containing the status of the task.
Raises:
HTTPException: If the flow is not found or if there is an error processing the request.",
"operationId": "webhook_run_flow_api_v1_webhook__flow_id_or_name__post",
"parameters": [
{
"in": "path",
"name": "flow_id_or_name",
"required": true,
"schema": {
"title": "Flow Id Or Name",
"type": "string"
}
},
{
"in": "query",
"name": "user_id",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "User Id"
}
}
],
"responses": {
"202": {
"content": {
"application/json": {
"schema": {
"additionalProperties": true,
"title": "Response Webhook Run Flow Api V1 Webhook Flow Id Or Name Post",
"type": "object"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Webhook Run Flow",
"tags": [
"Base"
]
}
},
"/api/v2/files": {
"delete": {
"description": "Delete all files for the current user.",
"operationId": "delete_all_files_api_v2_files_delete",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete All Files",
"tags": [
"Files"
]
},
"get": {
"description": "List the files available to the current user.",
"operationId": "list_files_api_v2_files_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/langflow__services__database__models__file__model__File"
},
"title": "Response List Files Api V2 Files Get",
"type": "array"
}
}
},
"description": "Successful Response"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "List Files",
"tags": [
"Files"
]
},
"post": {
"description": "Upload a file for the current user and track it in the database.",
"operationId": "upload_user_file_api_v2_files_post",
"parameters": [
{
"in": "query",
"name": "append",
"required": false,
"schema": {
"default": false,
"title": "Append",
"type": "boolean"
}
},
{
"in": "query",
"name": "ephemeral",
"required": false,
"schema": {
"default": false,
"title": "Ephemeral",
"type": "boolean"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_upload_user_file_api_v2_files_post"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/langflow__api__schemas__UploadFileResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Upload User File",
"tags": [
"Files"
]
}
},
"/api/v2/files/": {
"delete": {
"description": "Delete all files for the current user.",
"operationId": "delete_all_files_api_v2_files__delete",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete All Files",
"tags": [
"Files"
]
},
"get": {
"description": "List the files available to the current user.",
"operationId": "list_files_api_v2_files__get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/langflow__services__database__models__file__model__File"
},
"title": "Response List Files Api V2 Files Get",
"type": "array"
}
}
},
"description": "Successful Response"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "List Files",
"tags": [
"Files"
]
},
"post": {
"description": "Upload a file for the current user and track it in the database.",
"operationId": "upload_user_file_api_v2_files__post",
"parameters": [
{
"in": "query",
"name": "append",
"required": false,
"schema": {
"default": false,
"title": "Append",
"type": "boolean"
}
},
{
"in": "query",
"name": "ephemeral",
"required": false,
"schema": {
"default": false,
"title": "Ephemeral",
"type": "boolean"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_upload_user_file_api_v2_files__post"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/langflow__api__schemas__UploadFileResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Upload User File",
"tags": [
"Files"
]
}
},
"/api/v2/files/batch/": {
"delete": {
"description": "Delete multiple files by their IDs.",
"operationId": "delete_files_batch_api_v2_files_batch__delete",
"requestBody": {
"content": {
"application/json": {
"schema": {
"items": {
"format": "uuid",
"type": "string"
},
"title": "File Ids",
"type": "array"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete Files Batch",
"tags": [
"Files"
]
},
"post": {
"description": "Download multiple files as a zip file by their IDs.",
"operationId": "download_files_batch_api_v2_files_batch__post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"items": {
"format": "uuid",
"type": "string"
},
"title": "File Ids",
"type": "array"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Download Files Batch",
"tags": [
"Files"
]
}
},
"/api/v2/files/{file_id}": {
"delete": {
"description": "Delete a file by its ID.",
"operationId": "delete_file_api_v2_files__file_id__delete",
"parameters": [
{
"in": "path",
"name": "file_id",
"required": true,
"schema": {
"format": "uuid",
"title": "File Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete File",
"tags": [
"Files"
]
},
"get": {
"description": "Download a file by its ID or return its content as a string/bytes.
Args:
file_id: UUID of the file.
current_user: Authenticated user.
session: Database session.
storage_service: File storage service.
return_content: If True, return raw content (str) instead of StreamingResponse.
Returns:
StreamingResponse for client downloads or str for internal use.",
"operationId": "download_file_api_v2_files__file_id__get",
"parameters": [
{
"in": "path",
"name": "file_id",
"required": true,
"schema": {
"format": "uuid",
"title": "File Id",
"type": "string"
}
},
{
"in": "query",
"name": "return_content",
"required": false,
"schema": {
"default": false,
"title": "Return Content",
"type": "boolean"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Download File",
"tags": [
"Files"
]
},
"put": {
"description": "Edit the name of a file by its ID.",
"operationId": "edit_file_name_api_v2_files__file_id__put",
"parameters": [
{
"in": "path",
"name": "file_id",
"required": true,
"schema": {
"format": "uuid",
"title": "File Id",
"type": "string"
}
},
{
"in": "query",
"name": "name",
"required": true,
"schema": {
"title": "Name",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/langflow__api__schemas__UploadFileResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Edit File Name",
"tags": [
"Files"
]
}
},
"/api/v2/mcp/servers": {
"get": {
"description": "Get the list of available servers.",
"operationId": "get_servers_api_v2_mcp_servers_get",
"parameters": [
{
"in": "query",
"name": "action_count",
"required": false,
"schema": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Action Count"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get Servers",
"tags": [
"MCP"
]
}
},
"/api/v2/mcp/servers/{server_name}": {
"delete": {
"operationId": "delete_server_api_v2_mcp_servers__server_name__delete",
"parameters": [
{
"in": "path",
"name": "server_name",
"required": true,
"schema": {
"title": "Server Name",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Delete Server",
"tags": [
"MCP"
]
},
"get": {
"description": "Get a specific server.",
"operationId": "get_server_endpoint_api_v2_mcp_servers__server_name__get",
"parameters": [
{
"in": "path",
"name": "server_name",
"required": true,
"schema": {
"title": "Server Name",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get Server Endpoint",
"tags": [
"MCP"
]
},
"patch": {
"operationId": "update_server_endpoint_api_v2_mcp_servers__server_name__patch",
"parameters": [
{
"in": "path",
"name": "server_name",
"required": true,
"schema": {
"title": "Server Name",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MCPServerConfig"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Update Server Endpoint",
"tags": [
"MCP"
]
},
"post": {
"operationId": "add_server_api_v2_mcp_servers__server_name__post",
"parameters": [
{
"in": "path",
"name": "server_name",
"required": true,
"schema": {
"title": "Server Name",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MCPServerConfig"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Add Server",
"tags": [
"MCP"
]
}
},
"/api/v2/workflows": {
"get": {
"description": "Get status of workflow job by job ID",
"operationId": "get_workflow_status_api_v2_workflows_get",
"parameters": [
{
"description": "Job ID to query",
"in": "query",
"name": "job_id",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"description": "Job ID to query",
"title": "Job Id"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"description": "Synchronous workflow execution response.",
"properties": {
"created_timestamp": {
"title": "Created Timestamp",
"type": "string"
},
"errors": {
"default": [],
"items": {
"$ref": "#/components/schemas/ErrorDetail"
},
"title": "Errors",
"type": "array"
},
"flow_id": {
"title": "Flow Id",
"type": "string"
},
"inputs": {
"additionalProperties": true,
"default": {},
"title": "Inputs",
"type": "object"
},
"job_id": {
"anyOf": [
{
"type": "string"
},
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Id"
},
"object": {
"const": "response",
"default": "response",
"title": "Object",
"type": "string"
},
"outputs": {
"additionalProperties": {
"$ref": "#/components/schemas/ComponentOutput"
},
"default": {},
"title": "Outputs",
"type": "object"
},
"status": {
"$ref": "#/components/schemas/JobStatus"
}
},
"required": [
"flow_id",
"status"
],
"title": "WorkflowExecutionResponse",
"type": "object"
}
},
"text/event-stream": {
"description": "Server-sent events for streaming status",
"schema": {
"description": "Streaming event response.",
"properties": {
"raw_event": {
"additionalProperties": true,
"title": "Raw Event",
"type": "object"
},
"run_id": {
"title": "Run Id",
"type": "string"
},
"timestamp": {
"title": "Timestamp",
"type": "integer"
},
"type": {
"title": "Type",
"type": "string"
}
},
"required": [
"type",
"run_id",
"timestamp",
"raw_event"
],
"title": "WorkflowStreamEvent",
"type": "object"
}
}
},
"description": "Workflow status response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Get Workflow Status",
"tags": [
"Workflow"
]
},
"post": {
"description": "Execute a workflow with support for sync, stream, and background modes",
"operationId": "execute_workflow_api_v2_workflows_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WorkflowExecutionRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"discriminator": {
"mapping": {
"job": "#/components/schemas/WorkflowJobResponse",
"response": "#/components/schemas/WorkflowExecutionResponse"
},
"propertyName": "object"
},
"oneOf": [
{
"description": "Synchronous workflow execution response.",
"properties": {
"created_timestamp": {
"title": "Created Timestamp",
"type": "string"
},
"errors": {
"default": [],
"items": {
"$ref": "#/components/schemas/ErrorDetail"
},
"title": "Errors",
"type": "array"
},
"flow_id": {
"title": "Flow Id",
"type": "string"
},
"inputs": {
"additionalProperties": true,
"default": {},
"title": "Inputs",
"type": "object"
},
"job_id": {
"anyOf": [
{
"type": "string"
},
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Id"
},
"object": {
"const": "response",
"default": "response",
"title": "Object",
"type": "string"
},
"outputs": {
"additionalProperties": {
"$ref": "#/components/schemas/ComponentOutput"
},
"default": {},
"title": "Outputs",
"type": "object"
},
"status": {
"$ref": "#/components/schemas/JobStatus"
}
},
"required": [
"flow_id",
"status"
],
"title": "WorkflowExecutionResponse",
"type": "object"
},
{
"description": "Background job response.",
"properties": {
"created_timestamp": {
"title": "Created Timestamp",
"type": "string"
},
"errors": {
"default": [],
"items": {
"$ref": "#/components/schemas/ErrorDetail"
},
"title": "Errors",
"type": "array"
},
"flow_id": {
"title": "Flow Id",
"type": "string"
},
"job_id": {
"anyOf": [
{
"type": "string"
},
{
"format": "uuid",
"type": "string"
}
],
"title": "Job Id"
},
"links": {
"additionalProperties": {
"type": "string"
},
"title": "Links",
"type": "object"
},
"object": {
"const": "job",
"default": "job",
"title": "Object",
"type": "string"
},
"status": {
"$ref": "#/components/schemas/JobStatus"
}
},
"required": [
"job_id",
"flow_id",
"status"
],
"title": "WorkflowJobResponse",
"type": "object"
}
]
}
},
"text/event-stream": {
"description": "Server-sent events for streaming execution",
"schema": {
"description": "Streaming event response.",
"properties": {
"raw_event": {
"additionalProperties": true,
"title": "Raw Event",
"type": "object"
},
"run_id": {
"title": "Run Id",
"type": "string"
},
"timestamp": {
"title": "Timestamp",
"type": "integer"
},
"type": {
"title": "Type",
"type": "string"
}
},
"required": [
"type",
"run_id",
"timestamp",
"raw_event"
],
"title": "WorkflowStreamEvent",
"type": "object"
}
}
},
"description": "Workflow execution response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Execute Workflow",
"tags": [
"Workflow"
]
}
},
"/api/v2/workflows/stop": {
"post": {
"description": "Stop a running workflow execution",
"operationId": "stop_workflow_api_v2_workflows_stop_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WorkflowStopRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WorkflowStopResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Stop Workflow",
"tags": [
"Workflow"
]
}
},
"/health": {
"get": {
"operationId": "health_health_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
}
},
"summary": "Health",
"tags": [
"Health Check"
]
}
},
"/health_check": {
"get": {
"operationId": "health_check_health_check_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HealthResponse"
}
}
},
"description": "Successful Response"
}
},
"summary": "Health Check",
"tags": [
"Health Check"
]
}
},
"/logs": {
"get": {
"description": "Retrieve application logs with authentication required.
SECURITY: Logs may contain sensitive information and require authentication.",
"operationId": "logs_logs_get",
"parameters": [
{
"description": "The number of logs before the timestamp or the last log",
"in": "query",
"name": "lines_before",
"required": false,
"schema": {
"default": 0,
"description": "The number of logs before the timestamp or the last log",
"title": "Lines Before",
"type": "integer"
}
},
{
"description": "The number of logs after the timestamp",
"in": "query",
"name": "lines_after",
"required": false,
"schema": {
"default": 0,
"description": "The number of logs after the timestamp",
"title": "Lines After",
"type": "integer"
}
},
{
"description": "The timestamp to start getting logs from",
"in": "query",
"name": "timestamp",
"required": false,
"schema": {
"default": 0,
"description": "The timestamp to start getting logs from",
"title": "Timestamp",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Logs",
"tags": [
"Log"
]
}
},
"/logs-stream": {
"get": {
"description": "HTTP/2 Server-Sent-Event (SSE) endpoint for streaming logs.
Requires authentication to prevent exposure of sensitive log data.
It establishes a long-lived connection to the server and receives log messages in real-time.
The client should use the header \"Accept: text/event-stream\".",
"operationId": "stream_logs_logs_stream_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
}
},
"security": [
{
"OAuth2PasswordBearerCookie": []
},
{
"API key query": []
},
{
"API key header": []
}
],
"summary": "Stream Logs",
"tags": [
"Log"
]
}
}
}
}