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>",
      "created_at": 123,
      "updated_at": 123,
      "title": "<string>",
      "credit_usage": 123,
      "task_url": "<string>",
      "created_by_api_key": {
        "id": "<string>",
        "name": "<string>"
      }
    }
  ],
  "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.}

OAuth scope: create_task or manage_all_tasks — see the Open App guide. With create_task scope, only returns tasks created by this Open App. manage_all_tasks returns all of the user’s tasks.

Scope: Filter by task type — standard for regular tasks, project with project_id for project tasks, agent_subtask with agent_id for agent subtasks.Shortcut: Use agent-default as agent_id for the IM agent. See the Agents guide.

Filter by credential: Use oauth_client_id or api_key_id to return only tasks created by a specific Open App or API key. The two parameters are mutually exclusive. OAuth tokens with only the create_task scope are already limited to their own app’s tasks: they cannot filter by api_key_id or by another app’s oauth_client_id.

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

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) returns all tasks. "standard" returns regular tasks. "project" returns tasks within a project (requires project_id). "agent_subtask" returns 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

Filter tasks by the Open App (OAuth client) that created them. Mutually exclusive with api_key_id — passing both returns an invalid_argument error. OAuth tokens with only the create_task scope are already limited to their own app's tasks and may only pass their own client ID; passing another app's client ID returns a permission_denied error. IDs that don't match any of the user's tasks return an empty list.

api_key_id

string

Filter tasks by the API key that created them. Mutually exclusive with oauth_client_id — passing both returns an invalid_argument error. Not available to OAuth tokens with only the create_task scope (returns a permission_denied error). IDs that don't match any of the user's tasks return an empty list.

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

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

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>",
      "created_at": 123,
      "updated_at": 123,
      "title": "<string>",
      "credit_usage": 123,
      "task_url": "<string>",
      "created_by_api_key": {
        "id": "<string>",
        "name": "<string>"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

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

Getting Started

API Reference

Headers

Query Parameters

Response