{ "opencollection": "1.0.0", "info": { "name": "Langflow Base Chat API", "version": "1.9.0" }, "items": [ { "info": { "name": "Chat", "type": "folder" }, "items": [ { "info": { "name": "Build Flow", "type": "http" }, "http": { "method": "POST", "url": "{{baseUrl}}/api/v1/build/:flow_id/flow", "params": [ { "name": "flow_id", "value": "", "type": "path" }, { "name": "stop_component_id", "value": "", "type": "query" }, { "name": "start_component_id", "value": "", "type": "query" }, { "name": "log_builds", "value": "", "type": "query" }, { "name": "flow_name", "value": "", "type": "query" }, { "name": "event_delivery", "value": "", "type": "query" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "resource_owner_password_credentials", "accessTokenUrl": "api/v1/login", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "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_compon" }, { "info": { "name": "Cancel Build", "type": "http" }, "http": { "method": "POST", "url": "{{baseUrl}}/api/v1/build/:job_id/cancel", "params": [ { "name": "job_id", "value": "", "type": "path" } ], "auth": { "type": "oauth2", "flow": "resource_owner_password_credentials", "accessTokenUrl": "api/v1/login", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "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." }, { "info": { "name": "Get Build Events", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/api/v1/build/:job_id/events", "params": [ { "name": "job_id", "value": "", "type": "path" }, { "name": "event_delivery", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "resource_owner_password_credentials", "accessTokenUrl": "api/v1/login", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "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." }, { "info": { "name": "Build Public Tmp", "type": "http" }, "http": { "method": "POST", "url": "{{baseUrl}}/api/v1/build_public_tmp/:flow_id/flow", "params": [ { "name": "flow_id", "value": "", "type": "path" }, { "name": "stop_component_id", "value": "", "type": "query" }, { "name": "start_component_id", "value": "", "type": "query" }, { "name": "log_builds", "value": "", "type": "query" }, { "name": "flow_name", "value": "", "type": "query" }, { "name": "event_delivery", "value": "", "type": "query" } ], "body": { "type": "json", "data": "{}" } }, "docs": "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 reques" }, { "info": { "name": "Cancel Build Public", "type": "http" }, "http": { "method": "POST", "url": "{{baseUrl}}/api/v1/build_public_tmp/:job_id/cancel", "params": [ { "name": "job_id", "value": "", "type": "path" } ] }, "docs": "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." }, { "info": { "name": "Get Build Events Public", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/api/v1/build_public_tmp/:job_id/events", "params": [ { "name": "job_id", "value": "", "type": "path" }, { "name": "event_delivery", "value": "", "type": "query" } ] }, "docs": "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." } ] } ], "bundled": true }