Create an Agent Research Chat Message | Caesar

import requests
url = "https://api.caesar.xyz/agents/research/id/chat"
payload = { "content": "Can you provide the latest research findings on renewable energy adoption in Europe?" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "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 or null

Error details when status is failed.

resultslist of objects or null

Optional cited results for completed responses.

Authentication

Path parameters

Query parameters

Request

Response

Errors