Operators API
These endpoints are for verified operators to browse and claim jobs.
List Available Jobs
GET /operator/jobsList experiments available for claiming.
Response
{
"jobs": [
{
"experiment_id": "exp_abc123",
"title": "Test antibacterial activity",
"category": "microbiology",
"budget_usd": 300,
"deadline": "2026-02-10",
"bsl_level": "BSL-2",
"equipment_required": ["Biosafety cabinet", "Plate reader"],
"posted_at": "2026-01-27T10:00:00Z"
}
]
}Jobs are filtered to match your verified competencies and equipment access.
Claim Job
POST /operator/jobs/{experiment_id}/claimClaim a job to begin work.
Request Body
{
"equipment_confirmation": true,
"authorization_confirmation": true,
"estimated_start_date": "2026-01-29",
"notes": "Will begin Monday after receiving materials."
}Response
{
"experiment_id": "exp_abc123",
"claimed_at": "2026-01-27T15:30:00Z",
"deadline": "2026-02-10T23:59:59Z"
}Submit Results
POST /operator/jobs/{experiment_id}/submitSubmit experiment results.
Request Body
{
"hypothesis_supported": true,
"confidence_level": "high",
"summary": "Compound showed antibacterial activity with MIC of 16 μg/mL",
"measurements": [
{
"metric": "MIC",
"value": 16,
"unit": "μg/mL",
"condition": "E. coli ATCC 25922"
}
],
"statistics": {
"test_used": "t_test",
"p_value": 0.003
},
"raw_data_uploads": [
{
"name": "plate_reader_data.csv",
"format": "csv",
"content_base64": "..."
}
],
"documentation": {
"photos": [
{
"step": 3,
"image_base64": "...",
"caption": "MIC plate after 18h incubation"
}
],
"lab_notebook_base64": "..."
},
"notes": "All controls behaved as expected."
}Response
{
"experiment_id": "exp_abc123",
"status": "pending_approval",
"submitted_at": "2026-02-05T14:00:00Z"
}Operator Requirements
To become an operator:
- Complete identity verification
- Verify institutional affiliation
- Obtain PI/supervisor approval
- Pass competency assessment for claimed skills
Contact operators@litmus.science to start the verification process.