From 0456b2ea186c4354d7de2bf7abfceaf1aeb62fef Mon Sep 17 00:00:00 2001
From: snopoke <249606+snopoke@users.noreply.github.com>
Date: Tue, 19 May 2026 10:59:05 +0000
Subject: [PATCH] update API documentation from OpenAPI schema

---
 docs/api/channels.txt | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/docs/api/channels.txt b/docs/api/channels.txt
index 1fdd0b3a..25afd6f5 100644
--- a/docs/api/channels.txt
+++ b/docs/api/channels.txt
@@ -15,7 +15,9 @@ Provide either ``prompt_text`` (routes through the LLM/bot pipeline) or ``messag
     Content: application/json
     Schema: TriggerBotMessageRequest
   Responses:
-    200: No response body
+    200: 
+      Content: application/json
+      Schema: TriggerBotMessageResponse
     400: 
       Content: application/json
       Schema: Unknown
@@ -88,6 +90,12 @@ TriggerBotMessageRequest:
   - session_data: object
   - participant_data: object
 
+TriggerBotMessageResponse:
+  - session_id: string (required)
+  - url: string (required)
+  - team: Unknown (required)
+  - channel: string (required)
+
 SECURITY:
 - OAuth2
   - Authorization Code Flow (authorization url: /o/authorize/, token url: /o/token/)