Get a task
Tasks
Get a task
Get one Task by id and check its status.
GET
Get a task
Includes its
project_id. The main use is to check whether the agent is done: poll until status is completed (or failed / cancelled).
status moves idle → running → (completed | failed | cancelled): idle means
no message has been sent yet, running means the agent is working, completed
means it finished this turn, failed means something went wrong (the latest
agent message carries an error), and cancelled means you stopped it.
If you started a scientific review of this
Task, the record also carries review_status (running → done | failed) — poll
it the same way to know when the review is finished; review_error explains a
failure. Both fields are omitted until a review has been run.Authorizations
Requires an API key. See the Authentication guide.
Path Parameters
Response
200 - application/json
Task record.
Available options:
idle, running, completed, cancelled, failed Allowed value:
"task"Available options:
api, mcp, web, desktop, mobile Available options:
running, done, failed 