Skip to main content
GET
/
v2
/
task.detail
cURL
curl --request GET \
  --url 'https://api.manus.ai/v2/task.detail?task_id=<string>' \
  --header 'x-manus-api-key: <api-key>'
{
  "ok": true,
  "request_id": "<string>",
  "task": {
    "id": "<string>",
    "created_at": 123,
    "updated_at": 123,
    "title": "<string>",
    "credit_usage": 123,
    "task_url": "<string>",
    "created_by_api_key": {
      "id": "<string>",
      "name": "<string>"
    }
  }
}
Questions or issues? Contact us at api-support@manus.ai.
OAuth scope: create_task or manage_all_tasks — see the Open App guide. With create_task scope, can only access tasks created by this Open App.
Status only: This endpoint returns status and metadata. Use task.listMessages for the full conversation history and agent outputs.Shortcut: Use agent-default-main_task as task_id to check the IM agent’s main task.

Headers

​
x-manus-api-key
string

API key for direct authentication. Provide either this or Authorization, not both. See Authentication.

​
Authorization
string

OAuth2 access token in Bearer {token} format. Provide either this or x-manus-api-key, not both. See the Open App guide.

Example:

"Bearer {access_token}"

Query Parameters

​
task_id
string
required

The unique identifier of the task to retrieve. Supports the shortcut agent-default-main_task for the IM agent's main task.

Response

Task retrieved successfully.

​
ok
boolean

Whether the request was successful.

Example:

true

​
request_id
string

Unique identifier for this API request.

​
task
object

The task object with current status and metadata.