POST /v1/jobs/{jobId}/candidates

Adds candidates to a job you can write to, or updates the ones already recorded. A row is matched on molecule_id, compound_id and source together. Each row carries a status of selected, defer, reject or retest, which the route does not check against that list. The response reports how many rows were sent, not how many changed.

A project viewer cannot record candidates. With a project-scoped API key, a job outside the key's projects returns 403.

{
  "rows": [
    {
      "molecule_id": "mol-123",
      "status": "selected",
      "reason": "Best docking score",
      "source": "manual"
    }
  ]
}

curl -X POST 'https://ivybiosciences.com/api/v1/jobs/{jobId}/candidates' \
  -H "Authorization: Bearer $IVY_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "rows": [
    {
      "molecule_id": "mol-123",
      "status": "selected",
      "reason": "Best docking score",
      "source": "manual"
    }
  ]
}'