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
      • POSTRequest Agent Auth Code
      • POSTConfirm Agent Auth Code
      • POSTCreate an Agent Research Object
      • GETGet an Agent Research Object
      • GETGet Agent Research Results
      • GETGet a Single Agent Research Result
      • POSTCreate an Agent Research Update
      • POSTCreate an Agent Research Chat Message
      • GETGet an Agent Research Chat Message
      • GETStream an Agent Research Chat Message
      • POSTUpload an Agent File
      • GETGet Agent Balance
      • POSTCreate Agent Top-Up Checkout Session
API ReferenceAgent

Get an Agent Research Object

GET
https://api.caesar.xyz/agents/research/:id
GET
/agents/research/:id
$curl https://api.caesar.xyz/agents/research/id \
>     -H "Authorization: Bearer <token>"
1{
2  "status": "queued",
3  "query": "What are the latest advancements in renewable energy technologies?"
4}

Returns a token-aware research object without results.

Built with

Authentication

AuthorizationBearer

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

Path parameters

idstringRequiredformat: "uuid"
Research job identifier.

Response

Agent research object.
statusenum

Current status of the research job:

  • queued: Job accepted, waiting to start
  • searching: Gathering sources from the web
  • researching: Processing and analyzing sources
  • analyzing: Deep analysis of gathered information
  • summarizing: Generating final synthesis
  • completed: Research finished successfully
  • failed: Research encountered an error
querystring
Original research query.
contentstring or null
Synthesized research content. Null until complete.

Errors

401
Unauthorized Error
404
Not Found Error
500
Internal Server Error