more checks for valid worker/job_ids
better documentation for return value