---
title: "Create Response"
method: POST
path: "/api/v1/responses"
tags: ["OpenAI Responses API"]
---

# Create Response

`POST /api/v1/responses`

Create a response using OpenAI Responses API format.<br><br>This endpoint accepts a flow_id in the model parameter and processes<br>the input through the specified Langflow flow.<br><br>Args:<br>    request: OpenAI Responses API request with model (flow_id) and input<br>    background_tasks: FastAPI background task manager<br>    api_key_user: Authenticated user from API key<br>    http_request: The incoming HTTP request<br>    telemetry_service: Telemetry service for logging<br><br>Returns:<br>    OpenAI-compatible response or streaming response<br><br>Raises:<br>    HTTPException: For validation errors or flow execution issues

## Request body

- OpenAIResponsesRequest — OpenAI-compatible responses request with flow_id as model parameter.
  - `model` string, required — The flow ID to execute (used instead of OpenAI model)
  - `input` string, required — The input text to process
  - `stream` boolean — Whether to stream the response
  - `background` boolean — Whether to process in background
  - `tools` unknown[], nullable — Tools are not supported yet
    - unknown
  - `previous_response_id` string, nullable — ID of previous response to continue conversation
  - `include` string[], nullable — Additional response data to include, e.g., ['tool_call.results']

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2025-10-16** `9bd3e81318d7` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status

[Change history](https://skmtc.dev/langflow-ai/apis/langflow/changes/api/v1/responses/post.md)

---

[API](https://skmtc.dev/langflow-ai/apis/langflow.md) · [All operations](https://skmtc.dev/langflow-ai/apis/langflow/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/langflow-ai/langflow/revisions/b0ee9ddb8d9f/schema)