Skip to main content
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

Authorization
string
header
required

Requires an API key. See the Authentication guide.

Path Parameters

task_id
string
required

Response

200 - application/json

Task record.

id
string
required
created
integer
required
status
enum<string>
required
Available options:
idle,
running,
completed,
cancelled,
failed
object
string
default:task
Allowed value: "task"
project_id
string | null
title
string | null
platform
enum<string>
default:api
Available options:
api,
mcp,
web,
desktop,
mobile
review_status
enum<string> | null
Available options:
running,
done,
failed
review_error
string | null