Get Assistant Task

Poll the status and results of an assistant task. Call this endpoint repeatedly until the status is SUCCESS.

Task States

Progress Info (during STARTED)

While the task is running, the info field provides real-time progress:

{
  "id": "abc123",
  "status": "STARTED",
  "info": {
    "step": "EXECUTING_SEARCHES",
    "stepNumber": 3,
    "response": "partial response text...",
    "searches": ["query 1", "query 2"],
    "publicationsUsed": ["10.1234/example"],
    "publicationsConsulting": ["Author et al., Title, Journal, 2024"],
    "currentSearch": "current query being executed"
  }
}

Processing steps in order:

1. SCHEDULING_ASSISTANT — task queued
2. GENERATING_SEARCH_STRATEGY — AI generating search queries
3. EXECUTING_SEARCHES — running queries against Elasticsearch
4. RETRIEVING_UPLOADED_DOCUMENTS — loading reference check documents (if applicable)
5. RETRIEVING_PRIMARY_SOURCES — enriching with primary source data
6. COMPOSING_RESPONSE — preparing context for LLM
7. GENERATING_RESPONSE — LLM generating the answer

Success Result

{
  "id": "abc123",
  "status": "SUCCESS",
  "result": {
    "title": "How does protein structure affect function?",
    "sessionId": 42,
    "slug": "how-does-protein-structure-affect-function-xK9mP",
    "turns": [...],
    "lastUpdated": "2025-01-15",
    "createdAt": "2025-01-15",
    "tooManySessions": false
  }
}

Turn Structure

Each assistant turn in the turns array contains:

Reference Structure

Each reference in the references array: