Ivy Biosciences Harness API (v1.0.0)

Every public endpoint, grouped by lifecycle. Internal routes are not published here. Pages are regenerated from content/docs/api/openapi.json on every build.

Total: 97 operations across 16 groups.

Sessions

• GET /harness/sessions/{sessionId}/assets — List session assets
• GET /harness/sessions — List sessions
• GET /harness/sessions/{sessionId} — Get a session
• GET /harness/sessions/{sessionId}/workspace — Get a session's workspace
• GET /harness/sessions/{sessionId}/transcript — Export session transcript
• POST /harness/sessions — Create a session
• PUT /harness/sessions/{sessionId} — Update a session
• DELETE /harness/sessions/{sessionId} — Delete a session

Execution

• GET /harness/sessions/{sessionId}/events — Stream session events (SSE)
• POST /harness/sessions/{sessionId}/messages/sync — Send a message and wait for the full reply
• POST /harness/sessions/{sessionId}/execute — Execute a turn

Sync

• POST /harness/sessions/{sessionId}/sync — Sync session state

Checkpoints

• GET /harness/sessions/{sessionId}/checkpoints — List checkpoints
• POST /harness/sessions/{sessionId}/rollback — Rollback to checkpoint

Interrupts

• GET /harness/sessions/{sessionId}/interrupts — List pending interrupts
• POST /harness/sessions/{sessionId}/interrupt/{interruptId}/resolve — Resolve an interrupt

Tools

• GET /harness/tools — List available tools
• GET /v1/tools — List tools (public catalogue)
• GET /harness/tools/{name} — Get a tool by name

Jobs

• GET /api/v1/jobs — List your jobs
• GET /v1/jobs/{jobId}/artifacts — Download a job's output files
• GET /v1/jobs/{jobId}/artifacts/list-verifications — List a job's file verification records
• GET /v1/jobs/{jobId}/candidates — Read a job's study candidates
• GET /v1/jobs/{jobId}/checkpoints — Read a job's checkpoints
• GET /v1/jobs/{jobId}/curve-fits — Read a job's stored curve fits
• GET /v1/jobs/{jobId}/extractions — List a job's extracted files
• GET /v1/jobs/pricing — List job pricing
• GET /v1/jobs/{jobId}/readouts — Read a job's readouts
• GET /v1/jobs/{jobId}/snapshots/list — List a job's snapshots
• GET /v1/jobs/{jobId}/download/{artifactType} — Get a download link for one of a job's files by type
• GET /v1/jobs/{jobId}/download/plate-map — Download a job's plate map as CSV
• GET /v1/jobs/{jobId}/extract/pdb — Read a PDB file from a job's ZIP output
• GET /v1/jobs/{jobId}/extract/sdf — Read an SDF file from a job's ZIP output
• GET /v1/jobs/{jobId}/artifact-content — Read a job's result content
• GET /v1/jobs/{jobId}/context — Read a job's context counts
• GET /v1/jobs/{jobId}/manifest/latest — Find a job's latest manifest
• GET /v1/jobs/{jobId}/lineage — Read a job's lineage
• GET /v1/jobs/{jobId}/manifest/fetch — Read a job's latest manifest
• GET /v1/jobs/{jobId}/plate — Read a job's plate layout
• GET /v1/jobs/{jobId}/plate-types — List plate types and suggestions
• GET /v1/jobs/{jobId}/procurement — Read a job's procurement items
• GET /v1/jobs/{jobId}/qc — Read a job's plate QC badge
• GET /v1/jobs/{jobId}/qc/metrics — Read a job's plate QC metrics
• GET /v1/jobs/batch — Get several jobs by id
• GET /api/v1/jobs/{job_id} — Get job details
• GET /v1/jobs/{jobId}/events — Stream job events
• POST /v1/jobs/{jobId}/cancel — Cancel a job
• POST /api/v1/jobs — Submit a computation job
• POST /v1/jobs/{jobId}/fit-curves — Fit dose-response curves for a job
• POST /v1/jobs/{jobId}/lineage — Record a job's lineage
• POST /v1/jobs/{jobId}/resubmit — Resubmit a job
• POST /v1/jobs/{jobId}/plate-config — Save a job's plate type
• POST /v1/jobs/{jobId}/readouts — Save readouts for a job
• POST /v1/jobs/batch — Submit a batch of jobs
• POST /v1/jobs/{jobId}/undo — Undo a job's last plate update
• POST /v1/jobs/{jobId}/plate — Save wells on a job's plate
• POST /v1/jobs/{jobId}/readouts/upload — Upload a readout file to a job
• POST /v1/jobs/{jobId}/candidates — Record study candidates for a job
• POST /v1/jobs/{jobId}/artifacts/verify — Check output files against their SHA-256
• PATCH /v1/jobs/{jobId}/plate — Save wells on a job's plate (PATCH)
• PATCH /v1/jobs/{jobId}/fit-curves — Refit curves with exclusions and decisions
• DELETE /v1/jobs/{jobId}/candidates — Remove study candidates from a job

Agent

• GET /agent/runs/{id} — Fetch a previous run's execution trace
• GET /agent/health — Operational health for agent retry/backoff decisions
• GET /agent/whoami — Identify the caller, tier, and quota
• GET /orchestrate/{sessionId} — Read a session's background-job follow-up
• POST /agent/estimate — Preview cost + tool plan without executing
• POST /agent/feedback — Report the outcome of a previous run
• POST /orchestrate — Execute the biomedical agent

Benchmarking

• POST /bench — Benchmark the orchestrator (stateless)

Lookup

• GET /v1/lookup/molecule/enhanced — Analyze one molecule
• GET /v1/lookup/pubchem — Search PubChem by compound name
• GET /v1/lookup/uniprot — Search UniProt by protein name

API Keys

• GET /user/api-keys — List your API keys, or read one key's usage
• POST /user/api-keys — Create an API key
• PUT /user/api-keys — Update an API key
• PATCH /user/api-keys — Revoke, archive or move several API keys
• DELETE /user/api-keys — Revoke an API key

Audit

• GET /audit/chat-chain — List your chats for record verification
• GET /audit/manifest-feed — List a project's manifest events
• GET /audit/chat-chain/{chatId} — Verify a chat's record chain
• GET /audit/session-chain/{sessionId} — Verify a session's record chain
• POST /audit/feed — Query the audit activity feed

Chat Completions

• POST /v1/chat/completions — Create a chat completion

Compute

• POST /v1/sync/admet-quick — Quick ADMET estimate
• POST /v1/sync/molecular-properties — Calculate molecular properties
• POST /v1/sync/similarity — Compare two molecules
• POST /v1/sync/validate-smiles — Validate SMILES strings

Payments

• GET /x402/ping — Paid x402 service probe

Sandbox

• GET /harness/sandbox/list — List your sandboxes
• GET /harness/sandbox/{chatId}/export/{assetId}/download — Get a download link for an exported file
• GET /harness/sandbox/{chatId}/manifest — Get the sandbox file manifest
• GET /harness/sandbox/{chatId}/status — Get sandbox status
• POST /harness/sandbox/create — Create a sandbox for a chat
• POST /harness/sandbox/{chatId}/exec — Run a shell command
• POST /harness/sandbox/{chatId}/tool/{toolName} — Run a sandbox tool
• POST /harness/sandbox/{chatId}/terminate — Terminate the sandbox