Interested in joining a scientific study?Learn more
mymolecules

Async jobs

Heavy workflows return a job id.

Decode, Decode Sensory, Decode Symptoms, Design, Draft and Decode Food ID can return 202 queued. Poll the returned status_url or call the same endpoint with job_id until the status is completed or failed.

Polling pattern

Store the returned job_id and poll the status_url until the job reaches a final state.

{
  "data": {
    "job_id": "8a93f4...",
    "status": "queued",
    "status_url": "https://api.mymolecules.de/functions/v1/decode?job_id=8a93f4..."
  },
  "meta": {
    "request_id": "req_...",
    "api_version": "2026-07-10"
  }
}

Terminal statuses

queued and processing are not final. completed and failed are final. Stop polling on final states and apply normal retry rules only for transient HTTP errors.