Skip to main content
GET
/
v2
/
task.list
ListTasks
curl --request GET \
  --url https://api.manus.ai/v2/task.list \
  --header 'x-manus-api-key: <api-key>'
{
  "ok": true,
  "request_id": "<string>",
  "data": [
    {
      "id": "<string>",
      "status": "running",
      "created_at": 123,
      "updated_at": 123,
      "task_type": "standard",
      "share_visibility": "private"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}
Questions or issues? Contact us at api-support@manus.ai.

Authorizations

​
x-manus-api-key
string
header
required

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

Response

Tasks retrieved successfully.

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

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