task.list

GET

task.list

ListTasks

curl --request GET \
  --url https://api.manus.ai/v2/task.list

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/task.list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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.list"

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

	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.list")

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

request = Net::HTTP::Get.new(url)

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

{
  "ok": true,
  "request_id": "<string>",
  "data": [
    {
      "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
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

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

limit

integer

Number of tasks to return per page. Default: 20, Max: 100.

cursor

string

Pagination cursor from the previous response's next_cursor field. Omit for the first page.

order

enum<string>

Sort direction by creation time. "desc" (default) returns newest first, "asc" returns oldest first.

Available options:

asc,

desc

scope

enum<string>

Filter by task type.

all (default) — all tasks.
standard — regular tasks.
project — tasks in a project. Requires project_id.
agent_subtask — subtasks created by an agent. Requires agent_id.

Available options:

all,

agent_subtask,

project,

standard

agent_id

string

Filter tasks by agent. Required when scope="agent_subtask". Supports the shortcut agent-default for the IM agent. Use agent.list to get available agent IDs.

project_id

string

Filter tasks by project. Required when scope="project". Use project.list to get available project IDs.

oauth_client_id

string

Return only tasks created by this Open App. Mutually exclusive with api_key_id; passing both returns invalid_argument. Unknown IDs return an empty list.

API Key or Trusted client: any client ID.
Standard OAuth client: any client ID with manage_all_tasks; its own client ID only with create_task, and another ID returns permission_denied.

api_key_id

string

Return only tasks created by this API key. Mutually exclusive with oauth_client_id; passing both returns invalid_argument. Unknown IDs return an empty list.

API Key or Trusted client: any key ID.
Standard OAuth client: any key ID with manage_all_tasks; not available with create_task only, which returns permission_denied.

Response

Tasks retrieved successfully.

boolean

Whether the request was successful.

Example:

true

request_id

string

Unique identifier for this API request.

data

object[]

Array of task objects matching the filter criteria.

Hide child attributes

data.id

string

Unique identifier for the task.

data.status

enum<string>

Current main-agent status.

running — the agent is working.
stopped — the current run has stopped. Check has_running_background_jobs before treating the execution as complete.
waiting — the agent needs user input or a confirmation.
error — the task hit an unrecoverable error.

Available options:

running,

stopped,

waiting,

error

data.created_at

integer<int64>

Unix timestamp (seconds) when the task was created.

data.updated_at

integer<int64>

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

data.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

data.title

string

Title of the task.

data.credit_usage

integer<int32>

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

data.task_url

string

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

data.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

data.created_by_api_key.id

string

The API key ID.

data.created_by_api_key.name

string

The current display name of the API key.

data.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. Omitted when this information is not available (e.g. older tasks).

Available options:

manus-1.6,

manus-1.6-lite,

manus-1.6-max

data.has_running_background_jobs

boolean

Whether non-blocking background work is still pending, queued, or running. Independent of status: the main agent can be stopped while background work continues.

true — background work remains.
false — no active background work is known.
Omitted — unknown, typically an older task or a transient read failure; a later poll may fill it in. Do not treat omission as false.

See Task status for polling guidance.

has_more

boolean

Whether there are more tasks beyond this page. If true, use next_cursor to fetch the next page.

next_cursor

string

Cursor to pass as the cursor parameter for the next page. Only present when has_more is true.

⌘I

ListTasks

curl --request GET \
  --url https://api.manus.ai/v2/task.list

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/task.list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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.list"

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

	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.list")

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

request = Net::HTTP::Get.new(url)

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

{
  "ok": true,
  "request_id": "<string>",
  "data": [
    {
      "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
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

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

Getting Started

API Reference

Headers

Query Parameters

Response