Skip to main content
POST
Run a Scientific Review of a Task
A reviewer agent re-reads a completed task’s analysis and checks it for scientific accuracy, correct use of the data, unsupported claims, and stated limitations. A task that is idle or still running has nothing to review. The review runs in the background. This call returns immediately with status: "running" and does not return the review itself. When it finishes, a new entry appears in reviews on GET /tasks/{task_id}. Read the findings with GET /tasks/{task_id}/messages/{message_id} using that entry’s exact message_id. Calling this while a review is running returns the running state. Calling it after a review finishes starts a new one that replaces the previous result.

Authorizations

Authorization
string
header
required

Requires an API key. See the Authentication guide.

Path Parameters

task_id
string
required

Response

200 - application/json

The review is running in the background.

id
string
required
status
enum<string>
required
Available options:
running,
done,
failed
type
string
default:task_review
Allowed value: "task_review"