> ## Documentation Index
> Fetch the complete documentation index at: https://docs.manus.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# enterprise.task.list
> Lists tasks belonging to a specific user within the enterprise. Useful for previewing what data will be included in an export.
Questions or issues? Contact us at [api-support@manus.ai](mailto: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](/enterprise/v2/protocols).
## OpenAPI
````yaml GET /v2/enterprise.task.list
openapi: 3.1.0
info:
title: Manus Enterprise Data Export OpenAPI v2
description: >-
API for enterprise administrators to export user data for compliance
purposes (legal hold, internal audits). All responses are wrapped with
`{"ok": true, "request_id": "...", ...}` for success and `{"ok": false,
"request_id": "...", "error": {"code": "...", "message": "..."}}` for
errors. Every operation is callable via REST (paths below) or via Connect
RPC at `/dataexport.v2.EnterpriseDataExportV2Service/`.
version: 2.0.0
servers:
- url: https://api.manus.im
security:
- ApiKeyAuth: []
paths:
/v2/enterprise.task.list:
get:
summary: ListTasks
description: >-
Lists tasks belonging to a specific user within the enterprise. Useful
for previewing what data will be included in an export.
operationId: dataexport.v2.EnterpriseDataExportV2Service.ListTasks
parameters:
- name: user
in: query
required: true
schema:
type: string
example: user@example.com
description: User ID or email address to look up tasks for.
- name: start_time
in: query
schema:
type: string
format: date-time
description: Lower time bound (RFC3339).
- name: end_time
in: query
schema:
type: string
format: date-time
description: Upper time bound (RFC3339).
- name: page
in: query
schema:
type: integer
format: int32
description: Page number, starting from 1.
default: 1
example: 1
- name: page_size
in: query
schema:
type: integer
format: int32
description: Number of records per page.
default: 10
example: 10
- name: include_deleted
in: query
schema:
type: boolean
description: Include soft-deleted tasks.
default: false
responses:
'200':
description: Task records retrieved successfully.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
example: true
description: Whether the request was successful.
request_id:
type: string
description: Unique identifier for this API request.
records:
type: array
items:
$ref: '#/components/schemas/EnterpriseTaskRecord'
description: List of task records belonging to the user.
total:
type: integer
format: int32
description: >-
Total number of records matching the query (across all
pages).
4XX:
description: Error response.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
components:
schemas:
EnterpriseTaskRecord:
type: object
description: A task belonging to an enterprise user.
properties:
task_uid:
type: string
description: Unique task identifier.
user_id:
type: string
description: ID of the user who owns the task.
format: uuid
example: 123e4567-e89b-12d3-a456-426614174000
title:
type: string
description: Task title.
status:
type: string
description: Task lifecycle status (e.g., `SESSION_STATUS_STOPPED`).
created_at:
type: string
format: date-time
description: Task creation time.
updated_at:
type: string
format: date-time
description: Last update time.
last_message_time:
type: string
format: date-time
description: Time of the most recent message in the task.
is_deleted:
type: boolean
description: Whether the task has been soft-deleted by the user.
deleted_at:
type: string
format: date-time
description: Soft-deletion time. Only present when `is_deleted` is true.
audit_status:
type: integer
format: int32
description: >-
Numeric audit status. Values mirror the session `AuditStatus` enum
used elsewhere in the platform.
is_shared:
type: boolean
description: Whether the task has been shared (publicly or with a team).
is_blocked:
type: boolean
description: >-
Whether the task has been blocked (e.g. by content policy
enforcement).
space_id:
type: string
description: Space identifier the task belongs to.
project_uid:
type: string
description: UID of the Manus project that owns this task, if any.
scheduled_task:
type: boolean
description: Whether the task was created by a scheduled (recurring) job.
scheduled_task_uid:
type: string
description: >-
UID of the scheduled task definition. Only present when
`scheduled_task` is true.
ErrorResponse:
type: object
description: Standard error response format returned when a request fails.
properties:
ok:
type: boolean
example: false
description: Always false for error responses.
request_id:
type: string
description: >-
Unique identifier for this API request, useful for debugging with
support.
error:
type: object
description: Error details.
properties:
code:
type: string
description: >-
Machine-readable error code: `invalid_argument`, `not_found`,
`permission_denied`, `failed_precondition`, or `internal`.
message:
type: string
description: Human-readable error description explaining what went wrong.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
````