> ## 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 would be included in an export.

<sup>Questions or issues? Contact us at [api-support@manus.ai](mailto:api-support@manus.ai).</sup>

<Tip>
  **Use case:** Preview what tasks belong to a user before triggering an export.

  **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.
</Tip>


## OpenAPI

````yaml POST /dataexport.v1.EnterpriseDataExportService/ListTasks
openapi: 3.1.0
info:
  title: Manus Enterprise Data Export OpenAPI v1
  description: >-
    gRPC-style API for exporting enterprise user data. All endpoints are POSTs
    to `/dataexport.v1.EnterpriseDataExportService/<Method>` and return raw JSON
    with an inline `request_id`. See also [v2](/enterprise/v2/introduction),
    which provides the same operations over REST URLs with a unified response
    envelope.
  version: 1.0.0
servers:
  - url: https://api.manus.im
security:
  - ApiKeyAuth: []
paths:
  /dataexport.v1.EnterpriseDataExportService/ListTasks:
    post:
      summary: ListTasks
      description: >-
        Lists tasks belonging to a specific user within the enterprise. Useful
        for previewing what data would be included in an export.
      operationId: dataexport.v1.EnterpriseDataExportService.ListTasks
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                user:
                  type: string
                  description: User ID or email address.
                  example: user@example.com
                page:
                  type: integer
                  format: int32
                  description: Page number, starting from 1.
                  example: 1
                page_size:
                  type: integer
                  format: int32
                  description: Number of records per page.
                  example: 10
                start_time:
                  type: string
                  format: date-time
                  description: Lower time bound (RFC3339).
                end_time:
                  type: string
                  format: date-time
                  description: Upper time bound (RFC3339).
                include_deleted:
                  type: boolean
                  description: Include soft-deleted tasks.
              required:
                - user
                - page
                - page_size
      responses:
        '200':
          description: Task records retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  records:
                    type: array
                    items:
                      $ref: '#/components/schemas/EnterpriseTaskRecord'
                    description: List of task records.
                  total:
                    type: integer
                    format: int32
                    description: Total number of records matching the query.
                  request_id:
                    type: string
                    description: Request ID for tracing and auditing.
        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 gRPC-style error response.
      properties:
        code:
          type: string
          description: >-
            Error code: `INVALID_ARGUMENT`, `NOT_FOUND`, `PERMISSION_DENIED`,
            `FAILED_PRECONDITION`, or `INTERNAL`.
        message:
          type: string
          description: Human-readable error description.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````