Messages API
Messages live in Convex today and are read directly by the web app. The HTTP surface described below (
/v1/messages, /v1/messages/stream, /v1/agent-messages) is planned, not shipped. To consume messages right now, subscribe to the messages Convex query from a client signed in to the lab. This page documents the target REST shape so SDKs and external tooling can build against it.Message Roles
Send a Message
Send a message to the orchestrator or a specific agent. The response streams back in real time.Streaming Responses
When an agent responds, the message is created immediately withstreaming: true. The content field updates in real time as tokens are generated. When the response is complete, streaming flips to false.
Subscribe to Streaming (Real-Time)
HTTP Streaming (Server-Sent Events)
For non-Convex clients, the API supports SSE streaming:List Messages
Retrieve conversation history for a lab.Search Messages
Full-text search across conversation history.Delete a Message
Delete a single message. Only the Captain can delete messages.Agent-to-Agent Messages
Internal communication between agents is logged in theagent_messages table and visible in the Activity Feed. These are separate from Captain-facing chat messages.