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.
The '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
title: Page
type: integer
pages:
minimum: 0
title: Pages
type: integer
size:
minimum: 1
title: Size
type: integer
total:
minimum: 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
title: Page
type: integer
pages:
minimum: 0
title: Pages
type: integer
size:
minimum: 1
title: Size
type: integer
total:
minimum: 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.
Contains only the configuration values needed for public features,
without sensitive data.
The '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.
Serializes 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.
- UNSET: Default status, span has not ended yet
- OK: Span completed successfully
- 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.
Serializes 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.
Serializes 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
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