Ask the AI Assistant, streaming its work
Run one turn and stream it as Server-Sent Events: a plan frame whenever the AI Assistant publishes or ticks its plan, a step frame for each thing the AI Assistant actually did (read_context when the workspace has a business context, then plan, then write_column, retry_column and price_column for a column the message described, then one apply_action per action it applied), one turn frame naming the saved user message's sequence once it is saved (the Stop route is addressed by it), delta frames carrying the whole reply so far (assign, never append), a said frame when a later round of the turn starts writing (the words the reply showed until then, now a step: put step at at among the steps sent and empty the reply, which the next delta fills), then exactly one result frame with the same body the non-streaming route returns, the reply carrying its action cards, sent once the reply is saved. The last delta always equals the saved reply.
A turn that could not run ends in one error frame whose reason is limit, paused or not_found; a message naming a file that is not yours or was already sent ends in an error frame with no reason and nothing saved; any other failure is an error frame with no reason. A turn that breaks while running still ends in a result whose reply carries failed, and so does a stopped one, its reply reading Stopped by you.
Closing the connection does not cancel the turn: it finishes and saves its reply, so reopening the conversation shows the answer.
Request
- Base URL: https://api.getoneprofile.ai (the document declares no server; this is the origin it was published from)
- URL: https://api.getoneprofile.ai/assistant/chat/conversations/{conversation_id}/messages/stream/
- Auth: HTTP bearer
Path parameters
Request body
Response
A stream of Server-Sent Events. The final result frame's data is a turn; an error frame's data is a stream error.
Changes
No recorded changes to this operation across all 1 revision of this API.