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>",
    "status": "running",
    "created_at": 123,
    "updated_at": 123,
    "task_type": "standard",
    "share_visibility": "private",
    "title": "<string>",
    "credit_usage": 123,
    "task_url": "<string>",
    "created_by_api_key": {
      "id": "<string>",
      "name": "<string>"
    },
    "agent_profile": "manus-1.6",
    "has_running_background_jobs": true,
    "deleted_at": 123
  }
}

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

^{Questions or issues? Contact us at api-support@manus.ai.}

Auth:

API Key: Full access.
Standard OAuth client: Requires create_task or manage_all_tasks. With create_task, only tasks created by the same client; see Task visibility.
Trusted client: Full access.

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. An OAuth client requires the create_task or manage_all_tasks scope unless it is a Trusted team client or Trusted public client. 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 main-agent status.

running — the agent is working.
stopped — the main agent stopped. Read the results; has_running_background_jobs tells you whether background work may wake the task again.
waiting — the agent needs user input or a confirmation.
error — the task hit an unrecoverable error.
deleted — the task was deleted. Only returned by task.list with include_deleted=true.

Available options:

running,

stopped,

waiting,

error,

deleted

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. Empty for deleted tasks.

Available options:

private,

team,

public

task.title

string

Title of the task. Empty for deleted tasks.

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. a task.sendMessage override), not just the value supplied at task creation. For backward compatibility, responses retain the legacy manus-1.6, manus-1.6-lite, or manus-1.6-max form even though requests should use the stable standard, lite, or max names. When a Max task has a thinking level selected, the level is appended, for example manus-1.6-max-ultra. This includes tasks whose level was chosen in the Manus web app, not only tasks created with max-<level>. Clients that check for Max should match the manus-1.6-max prefix instead of the exact value, and should tolerate new values. Omitted when this information is not available (e.g. older tasks).

Available options:

manus-1.6,

manus-1.6-lite,

manus-1.6-max,

manus-1.6-max-medium,

manus-1.6-max-high,

manus-1.6-max-extra,

manus-1.6-max-ultra

task.has_running_background_jobs

boolean

Whether background work is still running after the main agent stopped. When true, a background process may wake the task again later, add messages, and change the results; keep polling if you want them. Older tasks do not report this field.

task.deleted_at

integer<int64>

Unix timestamp (seconds) when the task was deleted. Only present on deleted tasks returned by task.list with include_deleted=true.

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>",
    "status": "running",
    "created_at": 123,
    "updated_at": 123,
    "task_type": "standard",
    "share_visibility": "private",
    "title": "<string>",
    "credit_usage": 123,
    "task_url": "<string>",
    "created_by_api_key": {
      "id": "<string>",
      "name": "<string>"
    },
    "agent_profile": "manus-1.6",
    "has_running_background_jobs": true,
    "deleted_at": 123
  }
}

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

Getting Started

API Reference

Headers

Query Parameters

Response