generated: '2026-07-15' method: generated source: openapi/langflow-openapi.yml description: Recommended x-agentic-access execution contracts, classified heuristically from the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind audience per deployment. See research/curity/agentic-governance/. summary: operations: 95 by_action_class: connected: 42 acting: 53 by_consequence: read: 42 write: 51 safety-critical: 2 human_in_the_loop_required: 2 operations: - path: /api/v1/all method: get operationId: get_all_api_v1_all_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/build/{flow_id}/flow method: post operationId: build_flow_api_v1_build__flow_id__flow_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/build/{job_id}/cancel method: post operationId: cancel_build_api_v1_build__job_id__cancel_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/build/{job_id}/events method: get operationId: get_build_events_api_v1_build__job_id__events_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/build_public_tmp/{flow_id}/flow method: post operationId: build_public_tmp_api_v1_build_public_tmp__flow_id__flow_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/build_public_tmp/{job_id}/cancel method: post operationId: cancel_build_public_api_v1_build_public_tmp__job_id__cancel_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/build_public_tmp/{job_id}/events method: get operationId: get_build_events_public_api_v1_build_public_tmp__job_id__events_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/config method: get operationId: get_config_api_v1_config_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/files/delete/{flow_id}/{file_name} method: delete operationId: delete_file_api_v1_files_delete__flow_id___file_name__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/files/download/{flow_id}/{file_name} method: get operationId: download_file_api_v1_files_download__flow_id___file_name__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/files/images/{flow_id}/{file_name} method: get operationId: download_image_api_v1_files_images__flow_id___file_name__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/files/list/{flow_id} method: get operationId: list_files_api_v1_files_list__flow_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/files/profile_pictures/list method: get operationId: list_profile_pictures_api_v1_files_profile_pictures_list_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/files/profile_pictures/{folder_name}/{file_name} method: get operationId: download_profile_picture_api_v1_files_profile_pictures__folder_name___file_name__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/files/upload/{flow_id} method: post operationId: upload_file_api_v1_files_upload__flow_id__post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/flows/ method: delete operationId: delete_multiple_flows_api_v1_flows__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/flows/ method: get operationId: read_flows_api_v1_flows__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/flows/ method: post operationId: create_flow_api_v1_flows__post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/flows/basic_examples/ method: get operationId: read_basic_examples_api_v1_flows_basic_examples__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/flows/batch/ method: post operationId: create_flows_api_v1_flows_batch__post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/flows/download/ method: post operationId: download_multiple_file_api_v1_flows_download__post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/flows/public_flow/{flow_id} method: get operationId: read_public_flow_api_v1_flows_public_flow__flow_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/flows/upload/ method: post operationId: upload_file_api_v1_flows_upload__post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/flows/{flow_id} method: delete operationId: delete_flow_api_v1_flows__flow_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/flows/{flow_id} method: get operationId: read_flow_api_v1_flows__flow_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/flows/{flow_id} method: patch operationId: update_flow_api_v1_flows__flow_id__patch x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/flows/{flow_id} method: put operationId: upsert_flow_api_v1_flows__flow_id__put x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/flows/{flow_id}/events method: get operationId: get_flow_events_api_v1_flows__flow_id__events_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/flows/{flow_id}/events method: post operationId: create_flow_event_api_v1_flows__flow_id__events_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/mcp/project/{project_id} method: get operationId: list_project_tools_api_v1_mcp_project__project_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/mcp/project/{project_id} method: patch operationId: update_project_mcp_settings_api_v1_mcp_project__project_id__patch x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/mcp/project/{project_id}/composer-url method: get operationId: get_project_composer_url_api_v1_mcp_project__project_id__composer_url_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/mcp/project/{project_id}/install method: post operationId: install_mcp_config_api_v1_mcp_project__project_id__install_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/mcp/project/{project_id}/installed method: get operationId: check_installed_mcp_servers_api_v1_mcp_project__project_id__installed_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/monitor/builds method: delete operationId: delete_vertex_builds_api_v1_monitor_builds_delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/monitor/builds method: get operationId: get_vertex_builds_api_v1_monitor_builds_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/monitor/messages method: delete operationId: delete_messages_api_v1_monitor_messages_delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/monitor/messages method: get operationId: get_messages_api_v1_monitor_messages_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/monitor/messages/session/{old_session_id} method: patch operationId: update_session_id_api_v1_monitor_messages_session__old_session_id__patch x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/monitor/messages/session/{session_id} method: delete operationId: delete_messages_session_api_v1_monitor_messages_session__session_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/monitor/messages/sessions method: delete operationId: delete_messages_sessions_api_v1_monitor_messages_sessions_delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/monitor/messages/sessions method: get operationId: get_message_sessions_api_v1_monitor_messages_sessions_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/monitor/messages/shared method: get operationId: get_shared_messages_api_v1_monitor_messages_shared_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/monitor/messages/shared/session/{old_session_id} method: patch operationId: rename_shared_session_api_v1_monitor_messages_shared_session__old_session_id__patch x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/monitor/messages/shared/session/{session_id} method: delete operationId: delete_shared_messages_session_api_v1_monitor_messages_shared_session__session_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/monitor/messages/shared/sessions method: get operationId: get_shared_message_sessions_api_v1_monitor_messages_shared_sessions_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/monitor/messages/shared/{message_id} method: put operationId: update_shared_message_api_v1_monitor_messages_shared__message_id__put x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/monitor/messages/{message_id} method: put operationId: update_message_api_v1_monitor_messages__message_id__put x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/monitor/traces method: delete operationId: delete_traces_by_flow_api_v1_monitor_traces_delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/monitor/traces method: get operationId: get_traces_api_v1_monitor_traces_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/monitor/traces/{trace_id} method: delete operationId: delete_trace_api_v1_monitor_traces__trace_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/monitor/traces/{trace_id} method: get operationId: get_trace_api_v1_monitor_traces__trace_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/monitor/transactions method: get operationId: get_transactions_api_v1_monitor_transactions_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/projects/ method: get operationId: read_projects_api_v1_projects__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/projects/ method: post operationId: create_project_api_v1_projects__post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/projects/download/{project_id} method: get operationId: download_file_api_v1_projects_download__project_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/projects/upload/ method: post operationId: upload_file_api_v1_projects_upload__post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/projects/{project_id} method: delete operationId: delete_project_api_v1_projects__project_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/projects/{project_id} method: get operationId: read_project_api_v1_projects__project_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/projects/{project_id} method: patch operationId: update_project_api_v1_projects__project_id__patch x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/responses method: post operationId: create_response_api_v1_responses_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/run/advanced/{flow_id_or_name} method: post operationId: experimental_run_flow_api_v1_run_advanced__flow_id_or_name__post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/run/{flow_id_or_name} method: post operationId: simplified_run_flow_api_v1_run__flow_id_or_name__post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/starter-projects/ method: get operationId: get_starter_projects_api_v1_starter_projects__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/users/ method: get operationId: read_all_users_api_v1_users__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/users/ method: post operationId: add_user_api_v1_users__post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/users/whoami method: get operationId: read_current_user_api_v1_users_whoami_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/users/{user_id} method: delete operationId: delete_user_api_v1_users__user_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/users/{user_id} method: patch operationId: patch_user_api_v1_users__user_id__patch x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/users/{user_id}/reset-password method: patch operationId: reset_password_api_v1_users__user_id__reset_password_patch x-agentic-access: action-class: acting consequence: safety-critical subject: required audience: null token: max-ttl: 120 exchange: true purpose-required: true proof-of-possession: true escalation: human-in-the-loop: required audit: required - path: /api/v1/version method: get operationId: get_version_api_v1_version_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/webhook/{flow_id_or_name} method: post operationId: webhook_run_flow_api_v1_webhook__flow_id_or_name__post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v2/files method: delete operationId: delete_all_files_api_v2_files_delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v2/files method: get operationId: list_files_api_v2_files_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v2/files method: post operationId: upload_user_file_api_v2_files_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v2/files/ method: delete operationId: delete_all_files_api_v2_files__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v2/files/ method: get operationId: list_files_api_v2_files__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v2/files/ method: post operationId: upload_user_file_api_v2_files__post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v2/files/batch/ method: delete operationId: delete_files_batch_api_v2_files_batch__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v2/files/batch/ method: post operationId: download_files_batch_api_v2_files_batch__post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v2/files/{file_id} method: delete operationId: delete_file_api_v2_files__file_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v2/files/{file_id} method: get operationId: download_file_api_v2_files__file_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v2/files/{file_id} method: put operationId: edit_file_name_api_v2_files__file_id__put x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v2/mcp/servers method: get operationId: get_servers_api_v2_mcp_servers_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v2/mcp/servers/{server_name} method: delete operationId: delete_server_api_v2_mcp_servers__server_name__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v2/mcp/servers/{server_name} method: get operationId: get_server_endpoint_api_v2_mcp_servers__server_name__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v2/mcp/servers/{server_name} method: patch operationId: update_server_endpoint_api_v2_mcp_servers__server_name__patch x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v2/mcp/servers/{server_name} method: post operationId: add_server_api_v2_mcp_servers__server_name__post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v2/workflows method: get operationId: get_workflow_status_api_v2_workflows_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v2/workflows method: post operationId: execute_workflow_api_v2_workflows_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v2/workflows/stop method: post operationId: stop_workflow_api_v2_workflows_stop_post x-agentic-access: action-class: acting consequence: safety-critical subject: required audience: null token: max-ttl: 120 exchange: true purpose-required: true proof-of-possession: true escalation: human-in-the-loop: required audit: required - path: /health method: get operationId: health_health_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /health_check method: get operationId: health_check_health_check_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /logs method: get operationId: logs_logs_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /logs-stream method: get operationId: stream_logs_logs_stream_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none