---
title: "Build Flow"
method: POST
path: "/api/v1/build/{flow_id}/flow"
tags: ["Chat"]
---

# Build Flow

`POST /api/v1/build/{flow_id}/flow`

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

## Path parameters

- `flow_id` string, uuid, required

## Query parameters

- `stop_component_id` string, nullable
- `start_component_id` string, nullable
- `log_builds` boolean
- `flow_name` string, nullable
- `event_delivery` 'streaming' | 'direct' | 'polling'

## Request body

- BodyBuildFlowApiV1BuildFlowIdFlowPost
  - `data` FlowDataRequest
    - `edges` object[], required
    - `nodes` object[], required
    - `viewport` object, nullable
  - `files` string[], nullable
  - `inputs` InputValueRequest
    - `client_request_time` integer, nullable — Client-side timestamp in milliseconds when the request was initiated. Used to calculate accurate end-to-end duration.
    - `components` string[], nullable
    - `input_value` string, nullable
    - `session` string, nullable
    - `type` 'chat' | 'text' | 'any', nullable — Defines on which components the input value should be applied. 'any' applies to all input components.

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/langflow-ai/apis/langflow.md) · [All operations](https://skmtc.net/langflow-ai/apis/langflow/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langflow-ai/langflow/versions/22962dc5e81b/schema)