Skip to main content
GET
/
v2
/
enterprise.task.list
ListTasks
curl --request GET \
  --url https://api.manus.im/v2/enterprise.task.list \
  --header 'X-API-Key: <api-key>'
{
  "ok": true,
  "request_id": "<string>",
  "records": [
    {
      "task_uid": "<string>",
      "user_id": "123e4567-e89b-12d3-a456-426614174000",
      "title": "<string>",
      "status": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "last_message_time": "2023-11-07T05:31:56Z",
      "is_deleted": true,
      "deleted_at": "2023-11-07T05:31:56Z",
      "audit_status": 123,
      "is_shared": true,
      "is_blocked": true,
      "space_id": "<string>",
      "project_uid": "<string>",
      "scheduled_task": true,
      "scheduled_task_uid": "<string>"
    }
  ],
  "total": 123
}
Questions or issues? Contact us at api-support@manus.ai.
Use case: Preview what tasks belong to a user before triggering an export — useful when scoping enterprise.export.create with start_time / end_time.User identifier: user accepts either a user ID or an email address.Soft-deleted tasks: Set include_deleted=true to include tasks the user has deleted.Protocols: Also callable via Connect RPC. See Protocols.

Authorizations

X-API-Key
string
header
required

Query Parameters

user
string
required

User ID or email address to look up tasks for.

Example:

"user@example.com"

start_time
string<date-time>

Lower time bound (RFC3339).

end_time
string<date-time>

Upper time bound (RFC3339).

page
integer<int32>
default:1

Page number, starting from 1.

Example:

1

page_size
integer<int32>
default:10

Number of records per page.

Example:

10

include_deleted
boolean
default:false

Include soft-deleted tasks.

Response

Task records retrieved successfully.

ok
boolean

Whether the request was successful.

Example:

true

request_id
string

Unique identifier for this API request.

records
object[]

List of task records belonging to the user.

total
integer<int32>

Total number of records matching the query (across all pages).