API Reference
Operators

Operators API

These endpoints are for verified operators to browse and claim jobs.

List Available Jobs

GET /operator/jobs

List 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}/claim

Claim 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}/submit

Submit 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:

  1. Complete identity verification
  2. Verify institutional affiliation
  3. Obtain PI/supervisor approval
  4. Pass competency assessment for claimed skills

Contact operators@litmus.science to start the verification process.