task.detail

GET

task.detail

cURL

curl --request GET \
  --url 'https://api.manus.ai/v2/task.detail?task_id=<string>' \
  --header 'x-manus-api-key: <api-key>'

import requests

url = "https://api.manus.ai/v2/task.detail"

headers = {
    "x-manus-api-key": "<api-key>"
}

response = requests.get(url, headers=headers, params={"task_id": "<string>"})

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-manus-api-key': '<api-key>'}
};

fetch('https://api.manus.ai/v2/task.detail?task_id=<string>', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/task.detail?task_id=<string>",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-manus-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.manus.ai/v2/task.detail?task_id=<string>"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-manus-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/task.detail?task_id=<string>")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-manus-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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>"
    }
  }
}

{
  "ok": false,
  "request_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<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.

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.

Hide child attributes

task.id

string

Unique identifier for the task.

task.status

enum<string>

Current task status. "running" — agent is actively working. "stopped" — task has finished or been stopped. "waiting" — agent is paused and waiting for user input or confirmation. "error" — task encountered an unrecoverable error.

Available options:

running,

stopped,

waiting,

error

task.created_at

integer<int64>

Unix timestamp (seconds) when the task was created.

task.updated_at

integer<int64>

Unix timestamp (seconds) when the task was last updated.

task.task_type

enum<string>

Type of the task. "standard" — a regular standalone task. "project" — a task within a project. "agent_subtask" — a subtask created by an agent. Use task.list with scope to filter by task type.

Available options:

standard,

project,

agent_subtask

Who can view the task. "private" — only the task creator. "team" — all team members. "public" — anyone with the share link.

Available options:

private,

team,

public

task.title

string

Title of the task.

task.credit_usage

integer<int32>

Total credits consumed by the task. Only present when the task has consumed credits.

task.task_url

string

URL to view the task in the Manus webapp (e.g., https://manus.im/app/{task_id}).

task.created_by_api_key

object | null

The API key that created this task. Present when the task was created via the API; null or absent when created through the UI or other means. The name reflects the API key's current name, not a snapshot from creation time.

Hide child attributes

task.created_by_api_key.id

string

The API key ID.

task.created_by_api_key.name

string

The current display name of the API key.

task.agent_profile

enum<string>

Agent profile most recently used by the task — reflects the latest turn (e.g. an task.sendMessage override), not just the value supplied at task creation. Omitted when this information is not available (e.g. older tasks).

Available options:

manus-1.6,

manus-1.6-lite,

manus-1.6-max

⌘I

cURL

curl --request GET \
  --url 'https://api.manus.ai/v2/task.detail?task_id=<string>' \
  --header 'x-manus-api-key: <api-key>'

import requests

url = "https://api.manus.ai/v2/task.detail"

headers = {
    "x-manus-api-key": "<api-key>"
}

response = requests.get(url, headers=headers, params={"task_id": "<string>"})

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-manus-api-key': '<api-key>'}
};

fetch('https://api.manus.ai/v2/task.detail?task_id=<string>', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/task.detail?task_id=<string>",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-manus-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.manus.ai/v2/task.detail?task_id=<string>"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-manus-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/task.detail?task_id=<string>")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-manus-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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>"
    }
  }
}

{
  "ok": false,
  "request_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Getting Started

API Reference

Headers

Query Parameters

Response