From 6e35ee70ffbc54a3b26a158e7aebdaeddaae7a91 Mon Sep 17 00:00:00 2001
From: DrMelone <27028174+Classic298@users.noreply.github.com>
Date: Fri, 13 Feb 2026 22:31:50 +0100
Subject: [PATCH] openresponses api endpoint

---
 docs/getting-started/api-endpoints.md | 62 +++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)

diff --git a/docs/getting-started/api-endpoints.md b/docs/getting-started/api-endpoints.md
index 7ec3f89b..f88e9033 100644
--- a/docs/getting-started/api-endpoints.md
+++ b/docs/getting-started/api-endpoints.md
@@ -81,6 +81,68 @@ Access detailed API documentation for different services provided by Open WebUI:
       return response.json()
   ```
 
+### 🔄 OpenResponses
+
+- **Endpoint**: `POST /api/responses`
+- **Description**: Proxies requests to the [OpenResponses API](https://openresponses.org). Automatically routes to the correct upstream backend based on the `model` field, including Azure OpenAI deployments. Supports both streaming (SSE) and non-streaming responses.
+
+- **Curl Example**:
+
+  ```bash
+  curl -X POST http://localhost:3000/api/responses \
+  -H "Authorization: Bearer YOUR_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+        "model": "gpt-4.1",
+        "input": "Explain quantum entanglement in simple terms."
+      }'
+  ```
+
+- **Python Example**:
+
+  ```python
+  import requests
+
+  def create_response(token, model, input_text):
+      url = 'http://localhost:3000/api/responses'
+      headers = {
+          'Authorization': f'Bearer {token}',
+          'Content-Type': 'application/json'
+      }
+      data = {
+          "model": model,
+          "input": input_text
+      }
+      response = requests.post(url, headers=headers, json=data)
+      return response.json()
+  ```
+
+- **Streaming Example**:
+
+  ```python
+  import requests
+
+  def stream_response(token, model, input_text):
+      url = 'http://localhost:3000/api/responses'
+      headers = {
+          'Authorization': f'Bearer {token}',
+          'Content-Type': 'application/json'
+      }
+      data = {
+          "model": model,
+          "input": input_text,
+          "stream": True
+      }
+      response = requests.post(url, headers=headers, json=data, stream=True)
+      for line in response.iter_lines():
+          if line:
+              print(line.decode('utf-8'))
+  ```
+
+:::info
+The Responses API endpoint supports the same model-based routing as Chat Completions. If you have multiple OpenAI-compatible backends configured, the request is automatically routed based on which backend hosts the specified model. Azure OpenAI deployments are also supported with appropriate API version handling.
+:::
+
 ### 🔧 Filter and Function Behavior with API Requests
 
 When using the API endpoints directly, filters (Functions) behave differently than when requests come from the web interface.