For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
DocumentationAPI ReferenceChangelog
DocumentationAPI ReferenceChangelog
  • API Reference
      • GETGet chat messages for a research object
      • POSTCreate a chat message for a research object
      • GETGet a chat message
      • GETStream a chat message via SSE
API ReferenceChat

Stream a chat message via SSE

GET
https://api.caesar.xyz/research/:id/chat/:message_id/stream
GET
/research/:id/chat/:message_id/stream
$curl https://api.caesar.xyz/research/id/chat/message_id/stream \
>     -H "Authorization: Bearer <token>"
1"data: {\"id\":\"a3f1c9e2-7b4d-4f8a-9c3e-2d5f6b7a8c9d\",\"content\":\"The recent study on climate change indicates a significant rise in global temperatures over the past decade.[1] This trend is expected to continue if current emission levels persist.[2]\",\"citationIndices\":[1,2]}\ndata: {\"id\":\"a3f1c9e2-7b4d-4f8a-9c3e-2d5f6b7a8c9d\",\"content\":\"[1] Smith, J. et al. (2023). Climate Change and Global Warming Trends. Environmental Research Letters.\",\"citationIndex\":1}\ndata: {\"id\":\"a3f1c9e2-7b4d-4f8a-9c3e-2d5f6b7a8c9d\",\"content\":\"[2] Johnson, L. (2024). Emission Scenarios and Future Climate Projections. Journal of Climate Science.\",\"citationIndex\":2}\ndata: [DONE]"

Streams a completed chat message in chunks using Server-Sent Events. The final chunk includes results matching citation indices in the content.

Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequiredformat: "uuid"
Research job identifier.
message_idstringRequiredformat: "uuid"
Chat message identifier.

Response

SSE stream of chat completion chunks.

Errors

401
Unauthorized Error
404
Not Found Error
500
Internal Server Error