diff --git a/paths/chat/chat.yml b/paths/chat/chat.yml index 5a50b2f..20c8568 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/chat-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 3314cfa..26cf811 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 chat/reasoning + results to this URL once processing is complete. properties: task: description: Optional task grounding this conversation.