From 79dec2c0aa5598ff82d37255c1fd7dd4ac74eff8 Mon Sep 17 00:00:00 2001 From: Marcus Messer Date: Fri, 21 Aug 2026 09:31:54 +0100 Subject: [PATCH 1/3] Added support for asynchronous processing via callback URLs in ChatRequest schema --- paths/chat/chat.yml | 9 +++++++++ paths/chat/schemas/ChatRequest.yml | 9 +++++++++ 2 files changed, 18 insertions(+) diff --git a/paths/chat/chat.yml b/paths/chat/chat.yml index ff3dd0c..fc1abb2 100644 --- a/paths/chat/chat.yml +++ b/paths/chat/chat.yml @@ -27,6 +27,15 @@ post: content: "Can you explain polymorphism?" configuration: null + minimalChatAsynchronous: + summary: Asynchronous minimal chat request + value: + messages: + - role: USER + content: "Can you explain polymorphism?" + configuration: null + callbackUrl: "https://learning-platform.example.com/hooks/evaluate-result" + chatWithLlmConfig: summary: Chat request with optional LLM configuration value: diff --git a/paths/chat/schemas/ChatRequest.yml b/paths/chat/schemas/ChatRequest.yml index 8b8d850..2cc17ca 100644 --- a/paths/chat/schemas/ChatRequest.yml +++ b/paths/chat/schemas/ChatRequest.yml @@ -26,6 +26,15 @@ properties: - "null" description: Optional educational context (e.g., course material, task context). additionalProperties: true + callbackUrl: + type: + - string + - "null" + format: uri + description: > + Optional HTTPS callback URL for asynchronous processing. If provided, + the service may return 202 Accepted immediately and deliver feedback + results to this URL once processing is complete. configuration: type: - object From 4a70c22cf593f3cffb1b36dfef2dc3f58e8c6aa5 Mon Sep 17 00:00:00 2001 From: Marcus Messer <12846590+m-messer@users.noreply.github.com> Date: Tue, 29 Sep 2026 09:24:32 +0100 Subject: [PATCH 2/3] Update paths/chat/schemas/ChatRequest.yml MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Maximilian Sölch --- paths/chat/schemas/ChatRequest.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/paths/chat/schemas/ChatRequest.yml b/paths/chat/schemas/ChatRequest.yml index 2cc17ca..0f657cf 100644 --- a/paths/chat/schemas/ChatRequest.yml +++ b/paths/chat/schemas/ChatRequest.yml @@ -33,7 +33,7 @@ properties: format: uri description: > Optional HTTPS callback URL for asynchronous processing. If provided, - the service may return 202 Accepted immediately and deliver feedback + the service may return 202 Accepted immediately and deliver chat/reasoning results to this URL once processing is complete. configuration: type: From b6a23679f21fda73d5e5505847f312eb98c4977c Mon Sep 17 00:00:00 2001 From: Marcus Messer <12846590+m-messer@users.noreply.github.com> Date: Tue, 29 Sep 2026 09:24:40 +0100 Subject: [PATCH 3/3] Update paths/chat/chat.yml MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Maximilian Sölch --- paths/chat/chat.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/paths/chat/chat.yml b/paths/chat/chat.yml index fc1abb2..29f5a8e 100644 --- a/paths/chat/chat.yml +++ b/paths/chat/chat.yml @@ -34,7 +34,7 @@ post: - role: USER content: "Can you explain polymorphism?" configuration: null - callbackUrl: "https://learning-platform.example.com/hooks/evaluate-result" + callbackUrl: "https://learning-platform.example.com/hooks/chat-result" chatWithLlmConfig: summary: Chat request with optional LLM configuration