Elicit API

• query (required)

  string — The search query string

• corpus

  string, possible values: "elicit", "pubmed", default: "elicit" — Paper corpus to search. `elicit` (default) searches Elicit's full paper index; `pubmed` restricts to PubMed.

• filters

  object — Filters to narrow search results

  • excludeKeywords

    array — Keywords to exclude from results

    Items:

    string

  • hasPdf

    boolean — Only include papers with available PDFs

  • includeKeywords

    array — Keywords that must appear in the paper

    Items:

    string

  • maxEpochS

    integer — Maximum publication date as Unix epoch seconds

  • maxQuartile

    integer — Maximum journal quartile (1 = top 25%)

  • maxYear

    integer — Maximum publication year

  • minEpochS

    integer — Minimum publication date as Unix epoch seconds

  • minYear

    integer — Minimum publication year

  • pubmedOnly

    boolean — Only include papers from PubMed

  • retracted

    string, possible values: "exclude_retracted", "include_retracted", "only_retracted" — How to handle retracted papers. Defaults to exclude_retracted.

  • typeTags

    array — Filter by study type

    Items:

    string, possible values: "Review", "Meta-Analysis", "Systematic Review", "RCT", "Longitudinal"

• maxResults

  integer, default: 10 — Maximum number of results to return (1-10000)

• searchMode

  string, possible values: "semantic", "keyword", default: "semantic" — How to interpret `query`. `semantic` (default) runs Elicit's semantic search. `keyword` sends the query as a Lucene-style boolean expression directly to the corpus search API. Mutually exclusive with `filters` / `trialFilters` — put filter expressions into the query string in keyword mode.

Content-Type: application/json

Example:

{
  "papers": [
    {
      "elicitId": null,
      "title": "",
      "authors": [
        ""
      ],
      "year": null,
      "abstract": null,
      "doi": null,
      "pmid": null,
      "venue": null,
      "citedByCount": null,
      "urls": [
        ""
      ]
    }
  ],
  "warnings": [
    {
      "corpus": "elicit",
      "searchMode": "semantic",
      "message": "",
      "warningDetails": {
        "type": "",
        "messages": [
          ""
        ]
      }
    }
  ]
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

• query (required)

  string — The search query string

• maxResults

  integer, default: 10 — Maximum number of results to return (1-10000)

• searchMode

  string, possible values: "semantic", "keyword", default: "semantic" — How to interpret `query`. `semantic` (default) runs Elicit's semantic search. `keyword` sends the query as a Lucene-style boolean expression directly to the corpus search API. Mutually exclusive with `filters` / `trialFilters` — put filter expressions into the query string in keyword mode.

• trialFilters

  object — Clinical-trials filters (phase, recruitment status, results)

  • hasResults

    boolean — Only include trials that have posted results

  • phase

    array — Clinical trial phases to include

    Items:

    string, possible values: "NA", "EARLY_PHASE1", "PHASE1", "PHASE2", "PHASE3", "PHASE4"

  • recruitmentStatus

    array — Trial recruitment statuses to include

    Items:

    string, possible values: "ACTIVE_NOT_RECRUITING", "COMPLETED", "ENROLLING_BY_INVITATION", "NOT_YET_RECRUITING", "RECRUITING", "SUSPENDED", "TERMINATED", "WITHDRAWN", "AVAILABLE"

Content-Type: application/json

Example:

{
  "trials": [
    {
      "nctId": "NCT05646706",
      "title": "",
      "summary": null,
      "url": "https://clinicaltrials.gov/study/NCT05646706",
      "overallStatus": null,
      "phase": [
        ""
      ],
      "studyType": null,
      "enrollmentCount": null,
      "conditions": [
        ""
      ],
      "interventions": [
        ""
      ],
      "leadSponsor": null,
      "startDate": null,
      "primaryCompletionDate": null,
      "completionDate": null,
      "hasResults": null,
      "lastUpdatedYear": null
    }
  ],
  "warnings": [
    {
      "corpus": "elicit",
      "searchMode": "semantic",
      "message": "",
      "warningDetails": {
        "type": "",
        "messages": [
          ""
        ]
      }
    }
  ]
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

• researchQuestion (required)

  string — The research question to investigate. Elicit will search for relevant papers, screen them, and extract data to produce a structured report.

• isPublic

  boolean, default: false — Whether the report should be publicly accessible via its URL without authentication. Defaults to false.

• maxExtractPapers

  integer, default: 10 — Maximum number of papers to include in the final extraction table. Papers are screened for relevance before extraction. Defaults to 10.

• maxSearchPapers

  integer, default: 50 — Maximum number of papers to retrieve during the search phase. More papers means a more comprehensive but slower report. Defaults to 50.

• title

  string — Optional title for the report. If provided, Elicit will use this as the report title instead of generating one automatically from the research question.

Content-Type: application/json

Example:

{
  "type": "report",
  "sessionId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "status": "processing",
  "url": "https://elicit.com/review/5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "isPublic": false,
  "links": {
    "self": "https://elicit.com/api/v2/sessions/reports/5ad08bfb-cbe0-4911-a8c3-309760d33029",
    "resume": "https://elicit.com/api/v2/sessions/5ad08bfb-cbe0-4911-a8c3-309760d33029/resume"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "type": "report",
  "sessionId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "status": "processing",
  "executionStage": "gathering_sources",
  "url": "https://elicit.com/review/5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "isPublic": false,
  "result": {
    "title": "GLP-1 Receptor Agonists and Cardiovascular Outcomes: A Systematic Review",
    "summary": "This review analyzed 42 studies examining the cardiovascular effects of GLP-1 receptor agonists. The evidence suggests significant reductions in major adverse cardiovascular events (MACE), with semaglutide showing the strongest effect (HR 0.74, 95% CI 0.58-0.95)...",
    "reportBody": "# Introduction\n\nGLP-1 receptor agonists have emerged as...",
    "abstract": "This systematic review examines the cardiovascular effects of..."
  },
  "error": {
    "code": "",
    "message": ""
  },
  "pdfUrl": "https://s3.amazonaws.com/...",
  "docxUrl": "https://s3.amazonaws.com/...",
  "txtUrl": "https://s3.amazonaws.com/...",
  "bibUrl": "https://s3.amazonaws.com/...",
  "risUrl": "https://s3.amazonaws.com/...",
  "links": {
    "self": "https://elicit.com/api/v2/sessions/reports/5ad08bfb-cbe0-4911-a8c3-309760d33029",
    "resume": "https://elicit.com/api/v2/sessions/5ad08bfb-cbe0-4911-a8c3-309760d33029/resume"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

• researchQuestion (required)

  string — The research question the review is investigating.

• abstractScreening

  object — Abstract-stage screening. Supply `criteria`, `generate: true`, or both. Omit the field to skip.

  • criteria

    array — Explicit screening criteria.

    Items:

    • instructions (required)

      string — Plain-language instructions used to judge whether a paper meets this criterion

    • name (required)

      string — Short name for the criterion

  • generate

    boolean, default: false — When true, Elicit generates additional screening criteria.

• extraction

  object — Extraction stage. Supply `questions`, `generate`, or both. Omit to skip extraction entirely.

  • generate

    boolean, default: false — When true, Elicit generates additional extraction columns.

  • questions

    array — Explicit extraction columns.

    Items:

    • instructions (required)

      string — Plain-language instructions describing what to extract

    • name (required)

      string — Column header for this extraction question

    • choices

      array — Optional fixed list of allowed answers. Omit for free-text extraction. When set, the model is constrained to one of these values.

      Items:

      string

  • useFigures

    boolean, default: false — When true, model may consult figures (higher quality, slower). Subject to plan availability.

• fulltextScreening

  object — Fulltext-stage screening. Supply `criteria`, `reuseAbstractCriteria: true`, or both. Requires `abstractScreening` to be present. Omit to skip.

  • criteria

    array — Explicit fulltext-stage criteria.

    Items:

    • instructions (required)

      string — Plain-language instructions used to judge whether a paper meets this criterion

    • name (required)

      string — Short name for the criterion

  • reuseAbstractCriteria

    boolean, default: false — When true, the abstract-stage criteria are also applied at the fulltext stage.

• generateReport

  boolean, default: false — Generate a full report at the end of the review. Requires `extraction`.

• isPublic

  boolean, default: false — Whether the review should be publicly accessible via its URL without authentication. Defaults to false.

• protocolDetails

  string — Free-form context (PICO, methodology, inclusion/exclusion rationale) used when Elicit generates screening criteria, extraction columns, or the final report.

• searches

  array, default: [] — Searches that feed the review pipeline. If omitted or empty, Elicit runs a semantic search using `researchQuestion` as the query. Total search results are subject to plan-specific limits.

  Items:

  • query (required)

    string — Search query

  • corpus

    string, possible values: "elicit", "pubmed", "clinical_trials", default: "elicit" — Corpus to search. `elicit` covers ~138M papers across most domains and is the default. `pubmed` filters on literature from Pubmed only. `clinical_trials` is registered trials only.

  • maxResults

    integer, default: 200 — Maximum number of papers to retrieve from this search. Plan-specific caps apply.

  • searchMode

    string, possible values: "semantic", "keyword", default: "semantic" — `semantic` (default) uses vector-similarity retrieval; `keyword` uses literal keyword matching.

• title

  string — Optional title for the review.

Content-Type: application/json

Example:

{
  "type": "systematicReview",
  "sessionId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "status": "processing",
  "url": "",
  "isPublic": true,
  "links": {
    "self": "https://elicit.com/api/v2/sessions/reports/5ad08bfb-cbe0-4911-a8c3-309760d33029",
    "resume": "https://elicit.com/api/v2/sessions/5ad08bfb-cbe0-4911-a8c3-309760d33029/resume"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "type": "systematicReview",
  "sessionId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "status": "processing",
  "executionStage": "gathering_sources",
  "url": "",
  "isPublic": true,
  "error": {
    "code": "",
    "message": ""
  },
  "data": {
    "search": {
      "csv": "",
      "xlsx": ""
    },
    "screen": {
      "csv": "",
      "xlsx": ""
    },
    "fulltext": {
      "csv": "",
      "xlsx": ""
    },
    "extract": {
      "csv": "",
      "xlsx": ""
    },
    "report": {
      "result": {
        "title": "",
        "summary": "",
        "reportBody": null,
        "abstract": null
      },
      "pdf": "",
      "docx": "",
      "txt": "",
      "bib": "",
      "ris": ""
    }
  },
  "dataFreshness": null,
  "links": {
    "self": "https://elicit.com/api/v2/sessions/reports/5ad08bfb-cbe0-4911-a8c3-309760d33029",
    "resume": "https://elicit.com/api/v2/sessions/5ad08bfb-cbe0-4911-a8c3-309760d33029/resume"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "sessions": [
    {
      "type": "report",
      "sessionId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
      "status": "processing",
      "executionStage": "gathering_sources",
      "title": "What are the effects of GLP-1 receptor agonists on cardiovascular outcomes?",
      "url": "https://elicit.com/review/5ad08bfb-cbe0-4911-a8c3-309760d33029",
      "source": "api",
      "createdAt": "2025-06-15T14:30:00.000Z",
      "isPublic": false,
      "role": "owner",
      "links": {
        "self": "https://elicit.com/api/v2/sessions/reports/5ad08bfb-cbe0-4911-a8c3-309760d33029",
        "resume": "https://elicit.com/api/v2/sessions/5ad08bfb-cbe0-4911-a8c3-309760d33029/resume"
      }
    }
  ],
  "nextCursor": "2025-06-15T14:30:00.000Z_5ad08bfb-cbe0-4911-a8c3-309760d33029"
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "type": "report",
  "sessionId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "status": "processing",
  "executionStage": "screening_abstract",
  "url": "",
  "isPublic": true,
  "links": {
    "self": "https://elicit.com/api/v2/sessions/reports/5ad08bfb-cbe0-4911-a8c3-309760d33029",
    "resume": "https://elicit.com/api/v2/sessions/5ad08bfb-cbe0-4911-a8c3-309760d33029/resume"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

• email (required)

  string, format: email — Email address to share the session with, as a read-only recipient.

Content-Type: application/json

Example:

{
  "sessionId": "",
  "share": {
    "email": "colleague@example.com",
    "status": "registered",
    "role": "reader"
  },
  "url": ""
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "sessionId": "",
  "shares": [
    {
      "email": "colleague@example.com",
      "status": "registered",
      "role": "reader"
    }
  ],
  "url": ""
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

• email (required)

  string, format: email — Email address whose share (or pending invite) should be revoked.

Content-Type: application/json

Example:

{
  "sessionId": "",
  "email": "",
  "revoked": true
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "hasUsageRemaining": true,
  "percentUsed": 1,
  "periodStart": "",
  "periodEnd": "",
  "extraUsage": {
    "limitUsdCents": null,
    "spentUsdCents": 1
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

• content_type (required)

  string — MIME type of the file.

• filename (required)

  string — Original filename of the upload. Used as the display name in the session.

• size_bytes (required)

  integer — Exact size of the file in bytes. Must match the uploaded object exactly. Maximum 31457280 bytes (30 MB).

Content-Type: application/json

Example:

{
  "file_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "upload_url": "",
  "expires_at": "2026-07-23T15:00:00.000Z"
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

• query (required)

  string — The initial query for the research agent. Elicit creates a stateful research session that investigates the query. The session is continuable in the Elicit web interface.

• attachments

  array — Files to attach to this turn, each referencing a file_id from POST /api/v2/files. Attached files are made available to the research agent exactly as uploads made in the web interface are.

  Items:

  • file_id (required)

    string, format: uuid — The file_id returned by POST /api/v2/files for a previously uploaded file.

Content-Type: application/json

Example:

{
  "sessionId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "status": "processing",
  "url": "https://elicit.com/agent/a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "type": "agent",
  "sessionId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "status": "processing",
  "title": "",
  "url": "",
  "source": "api",
  "createdAt": "2025-06-15T14:30:00.000Z",
  "isPublic": true,
  "links": {
    "self": "https://elicit.com/api/v2/sessions/reports/5ad08bfb-cbe0-4911-a8c3-309760d33029",
    "resume": "https://elicit.com/api/v2/sessions/5ad08bfb-cbe0-4911-a8c3-309760d33029/resume"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "sessionId": "",
  "status": "processing",
  "events": [
    {
      "eventId": "",
      "createdAt": null,
      "kind": "user_message",
      "messageId": "",
      "text": "",
      "isInitial": true
    }
  ],
  "cursor": "",
  "url": ""
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

• message (required)

  string — The message to insert into the running research agent session.

• attachments

  array — Files to attach to this turn, each referencing a file_id from POST /api/v2/files. Attached files are made available to the research agent exactly as uploads made in the web interface are.

  Items:

  • file_id (required)

    string, format: uuid — The file_id returned by POST /api/v2/files for a previously uploaded file.

Content-Type: application/json

Example:

{
  "sessionId": "",
  "status": "processing",
  "messageId": "",
  "url": ""
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "sessionId": "",
  "status": "stopping",
  "url": ""
}

Content-Type: application/json

Example:

{
  "sessionId": "",
  "status": "stopping",
  "url": ""
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "sessionId": "",
  "artifacts": [
    {
      "artifactId": "",
      "kind": "agent-saved-file",
      "format": null,
      "filename": "",
      "contentType": null,
      "sizeBytes": null,
      "createdAt": "2025-06-15T14:30:00.000Z"
    }
  ],
  "deliveredOutputs": [
    {
      "artifactId": "",
      "kind": "table",
      "title": "",
      "caption": null,
      "rowCount": null,
      "createdAt": "2025-06-15T14:30:00.000Z",
      "downloadFormats": [
        "csv"
      ]
    }
  ],
  "url": ""
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "downloadUrl": "",
  "expiresAt": "2025-06-15T15:00:00.000Z",
  "filename": "",
  "contentType": null
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json