Create an Agent Research Chat Message | Caesar

curl -X POST https://api.caesar.xyz/agents/research/id/chat \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "content": "Can you provide the latest research findings on renewable energy adoption in Europe?"
}'

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "content": "The latest studies indicate a significant increase in renewable energy adoption across Europe, with solar and wind power leading the growth.",
  "status": "completed",
  "error_message": "",
  "results": [
    {
      "id": "1e4d5f7a-8c3b-4f2a-9d6e-7b8a9c0d1234",
      "title": "European Renewable Energy Report 2024",
      "url": "https://www.europeanenergyreport.eu/2024/renewable-energy-adoption",
      "citation_index": 1
    }
  ]
}

Creates an async chat message for a research job. Set stream=true to reuse the SSE chat chunk stream.

Authentication

AuthorizationBearer

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

Path parameters

idstringRequiredformat: "uuid"

Research job identifier.

Query parameters

streambooleanOptionalDefaults to false

When true, responds with an SSE stream of chat chunks.

Request

This endpoint expects an object.

contentstringRequired

Chat message content.

Response

Chat message created or stream started.

idstringformat: "uuid"

Assistant message identifier.

contentstring

Assistant message content.

statusenum

Status of the assistant chat message.

Allowed values:

error_messagestring

Error details when status is failed.

resultslist of objects

Optional cited results for completed responses.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error