{
"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
}