BIOS API

Access BIOS Public API programmatically via REST API, MCP, and OpenAPI.

The BIOS API gives you programmatic access to BIOS Public API services: Deep Research, standalone subagents (Literature + Data Analysis), file management, and MCP integration.

Base URL

All API requests are made to:

https://api.ai.bio.xyz

Authentication

All API requests require a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Getting Your API Key

Go to Account Settings → API Keys
Click Create API Key
Give it a name (e.g. "My Research Bot") and click Generate
Copy the key immediately — it won't be shown again

Your API key starts with bio_sk_ and looks like this:

bio_sk_1SyXtp...YYx9If7A

Keep your API key secret. Do not share it publicly or commit it to version control. If compromised, revoke it immediately from the API Keys page and generate a new one.

OpenAPI Specification

The full OpenAPI 3.1 spec is available at:

https://api.ai.bio.xyz/openapi.json

Use it to auto-generate client libraries, import into Postman, or inspect schemas. You can also browse and test endpoints interactively in the API Playground.

Endpoint Groups (Current)

Group	What it's for	Docs
Deep Research	Start/poll long-running research sessions	This page
Files	Upload and manage reusable files	This page
Subagent API	Direct literature and data analysis tasks	Subagent API
MCP	Connect BIOS tools to MCP-compatible clients	MCP Integration

Complete Route Map (Current)

The current REST surface in /openapi.json is:

GET    /health
GET    /deep-research
GET    /deep-research/{conversationId}
GET    /deep-research/{conversationId}/artifacts/{artifactId}/download
POST   /deep-research/start
GET    /files
GET    /files/{file_id}
POST   /files/upload
DELETE /files/{file_id}
POST   /agents/literature/query
GET    /agents/literature/jobs/{jobId}
GET    /agents/literature
POST   /agents/analysis/run
GET    /agents/analysis/tasks/{taskId}
GET    /agents/analysis/tasks/{taskId}/artifacts/{artifactId}/download
GET    /agents/analysis

Health Check

GET /health

Returns API status. No authentication required.

Deep Research API

Start Deep Research

POST /deep-research/start

Submit a research question and return immediately with a conversationId while research runs asynchronously.

Request Body (application/x-www-form-urlencoded):

Parameter	Type	Required	Description
`message`	string	Yes	Research question or follow-up instruction
`conversationId`	string	No	Continue an existing conversation
`researchMode`	string	No	`steering`, `semi-autonomous`, `fully-autonomous`
`fileIds`	string	No	JSON array or comma-separated file IDs to attach

Example — Start a new session:

curl -X POST "https://api.ai.bio.xyz/deep-research/start" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "message=What compounds show senolytic activity in human clinical trials?" \
  -d "researchMode=semi-autonomous"

Example — Continue with files:

curl -X POST "https://api.ai.bio.xyz/deep-research/start" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "message=Focus on clinical outcomes for D+Q combination therapy" \
  -d "conversationId=conv_abc123" \
  -d 'fileIds=["file_123","file_456"]'

List Conversations

GET /deep-research

Retrieve a cursor-paginated list of conversations.

Get Conversation Detail

GET /deep-research/{conversationId}

Retrieve full conversation state and messages.

Download Conversation Artifact

GET /deep-research/{conversationId}/artifacts/{artifactId}/download

Generate a presigned URL for an artifact produced during deep research.

Files API

Upload File

POST /files/upload

Upload a file once and reuse it in deep research or analysis tasks.

Request: multipart/form-data with file.

List Files

GET /files

List previously uploaded files.

Get File Details

GET /files/{file_id}

Fetch metadata for one file.

Delete File

DELETE /files/{file_id}

Delete file metadata and underlying storage object.

Subagent API

Direct subagent endpoints are available today:

POST /agents/literature/query
GET /agents/literature/jobs/{jobId}
GET /agents/literature
POST /agents/analysis/run
GET /agents/analysis/tasks/{taskId}
GET /agents/analysis/tasks/{taskId}/artifacts/{artifactId}/download
GET /agents/analysis

See Subagent API for request shapes and polling flows.

MCP Integration

BIOS is also available as an MCP server. See MCP Integration for setup, authentication flow, and tool reference.

Example: Query Literature (Subagent)

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 is the latest evidence on NAD+ boosters and healthy aging?",
    "mode": "fast"
  }'

Rate Limits

API rate limits are tied to your plan. See Plans & Credits for details.

Open Source

The BioAgents framework is available on GitHub. You can deploy your own instance today.