chat-ai
chat_messages

Submit Tool Result

Submit a tool result (e.g. user's ask_user selection) and resume streaming.

This endpoint:

  1. Validates ownership
  2. Finds the pending ask_user tool call on the last assistant message
  3. Marks it completed and records the result
  4. Constructs a ToolMessage and resumes the LangGraph agent
  5. Streams the continuation via SSE (same event format as send_message)
post/api/v1/chat-ai/conversations/{conversation_id}/tool-result

Path parameters

conversation_idstring uuid required

Request body

tool_call_idstring required

OpenAI tool_call_id from the AIMessage

tool_namestring required

Name of the tool (e.g. ask_user)

resultobject required

Structured result, e.g. {"selected_id": "opt1", "selected_label": "Option A"}

Response

Successful Response

{"stackTrail":"paths:/api/v1/chat-ai/conversations/{conversation_id}/tool-result:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes