docs: build OpenAPI spec and cut version 1.10 (#13537)

* build-api

* bump-version-to-1.10

* fix-broken-links

docs/versioned_docs/version-1.10.0/API-Reference/python-examples/api-users/add-user.py

@@ -0,0 +1,18 @@
+import os
+import uuid
+
+import requests
+
+base = os.environ.get("LANGFLOW_URL", "")
+api_key = os.environ.get("LANGFLOW_API_KEY", "")
+
+headers = {"Content-Type": "application/json", "x-api-key": api_key}
+
+payload = {
+    "username": f"docsuser_{uuid.uuid4().hex[:12]}",
+    "password": "securepassword123",
+}
+
+response = requests.post(f"{base}/api/v1/users/", headers=headers, json=payload, timeout=30)
+response.raise_for_status()
+print(response.text)

docs/versioned_docs/version-1.10.0/API-Reference/python-examples/api-users/delete-user.py

@@ -0,0 +1,22 @@
+import os
+import uuid
+
+import requests
+
+base = os.environ.get("LANGFLOW_URL", "")
+api_key = os.environ.get("LANGFLOW_API_KEY", "")
+
+headers = {"accept": "application/json", "Content-Type": "application/json", "x-api-key": api_key}
+
+create = requests.post(
+    f"{base}/api/v1/users/",
+    headers=headers,
+    json={"username": f"docsdel_{uuid.uuid4().hex[:12]}", "password": "securepassword123"},
+    timeout=30,
+)
+create.raise_for_status()
+user_id = create.json()["id"]
+
+delete = requests.delete(f"{base}/api/v1/users/{user_id}", headers=headers, timeout=30)
+delete.raise_for_status()
+print(delete.text)

docs/versioned_docs/version-1.10.0/API-Reference/python-examples/api-users/get-current-user.py

@@ -0,0 +1,15 @@
+import os
+
+import requests
+
+url = f"{os.getenv('LANGFLOW_URL', '')}/api/v1/users/whoami"
+
+headers = {
+    "accept": "application/json",
+    "x-api-key": f"{os.getenv('LANGFLOW_API_KEY', '')}",
+}
+
+response = requests.request("GET", url, headers=headers)
+response.raise_for_status()
+
+print(response.text)

docs/versioned_docs/version-1.10.0/API-Reference/python-examples/api-users/list-all-users.py

@@ -0,0 +1,15 @@
+import os
+
+import requests
+
+url = f"{os.getenv('LANGFLOW_URL', '')}/api/v1/users/?skip=0&limit=10"
+
+headers = {
+    "accept": "application/json",
+    "x-api-key": f"{os.getenv('LANGFLOW_API_KEY', '')}",
+}
+
+response = requests.request("GET", url, headers=headers)
+response.raise_for_status()
+
+print(response.text)

docs/versioned_docs/version-1.10.0/API-Reference/python-examples/api-users/reset-password.py

@@ -0,0 +1,24 @@
+import os
+
+import requests
+
+base = os.environ.get("LANGFLOW_URL", "")
+api_key = os.environ.get("LANGFLOW_API_KEY", "")
+
+headers = {"Content-Type": "application/json", "x-api-key": api_key}
+
+who = requests.get(f"{base}/api/v1/users/whoami", headers=headers, timeout=30)
+who.raise_for_status()
+user_id = who.json()["id"]
+
+# Must differ from the current password (default superuser is often langflow/langflow).
+payload = {"password": "DocsExampleResetPass2025!"}
+
+response = requests.patch(
+    f"{base}/api/v1/users/{user_id}/reset-password",
+    headers=headers,
+    json=payload,
+    timeout=30,
+)
+response.raise_for_status()
+print(response.text)

docs/versioned_docs/version-1.10.0/API-Reference/python-examples/api-users/update-user.py

@@ -0,0 +1,18 @@
+import os
+
+import requests
+
+base = os.environ.get("LANGFLOW_URL", "")
+api_key = os.environ.get("LANGFLOW_API_KEY", "")
+
+headers = {"Content-Type": "application/json", "x-api-key": api_key}
+
+who = requests.get(f"{base}/api/v1/users/whoami", headers=headers, timeout=30)
+who.raise_for_status()
+user_id = who.json()["id"]
+
+payload = {"is_active": True}
+
+response = requests.patch(f"{base}/api/v1/users/{user_id}", headers=headers, json=payload, timeout=30)
+response.raise_for_status()
+print(response.text)