BioAgents Research Assistant

Main endpoints

Registration answers 202 and ingests in the background, so a long PDF never blocks a connection. The agent's text model comes from OpenAI, Anthropic, or OpenRouter, whichever the deployment is configured with. The routes below are the main ones; the architecture guide lists the rest.

The BioAgents routes check the session token and involve no UCAN. The API forwards questions to the agent under its own server key rather than under the user's identity.

Register, poll, ask (JavaScript)

// 1. Register a paper you uploaded. Ingestion runs in the background.
const res = await fetch('https://api.ekayana.io/api/research-paper', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    file_cid: 'bafybeig...',
    title: 'CRISPR-Cas9 Gene Editing for Neurodegenerative Diseases',
    authors: ['Jane Smith', 'John Doe'],
    doi: '10.1038/s41586-021-03819-2',
  }),
});

// 2. The response is 202 with the paper's DID. Poll until status is "completed".
const { did } = await res.json();
const paper = await fetch(
  `https://api.ekayana.io/api/research-paper/did/${did}`,
  { headers: { Authorization: `Bearer ${token}` } },
);

// 3. Ask the agent. The answer comes back with the DOIs it cited.
const answer = await fetch('https://api.ekayana.io/api/bioagents/query', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ query: 'What is known about CRISPR in neurodegeneration?' }),
});