Subagent API

Direct API access to the Literature Agent and Data Analysis Agent.

The Subagent API is available now. You can call Literature and Data Analysis directly without running a full deep research conversation.

All requests use:

Authorization: Bearer YOUR_API_KEY

Literature API

MethodPathPurpose
POST/agents/literature/queryStart a literature query
GET/agents/literature/jobs/{jobId}Poll deep-mode job status/results
GET/agents/literatureList past literature tasks

Start Query

curl -X POST "https://api.ai.bio.xyz/agents/literature/query" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "What are the newest clinical findings on senolytics?",
    "mode": "deep"
  }'

mode: "fast" returns answer content immediately.
mode: "deep" returns a jobId; poll with GET /agents/literature/jobs/{jobId}.

Data Analysis API

MethodPathPurpose
POST/agents/analysis/runStart a data analysis task
GET/agents/analysis/tasks/{taskId}Poll task status/results
GET/agents/analysis/tasks/{taskId}/artifacts/{artifactId}/downloadGet artifact download URL
GET/agents/analysisList past analysis tasks

Start Analysis Task

curl -X POST "https://api.ai.bio.xyz/agents/analysis/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "taskDescription=Run PCA and differential expression on uploaded dataset"

This endpoint is async and returns a taskId. Poll GET /agents/analysis/tasks/{taskId} until complete.

Using Uploaded Files

Analysis tasks can include previously uploaded file IDs (fileIds).
See BIOS API Overview for file upload endpoints.

Related