# Get Incomplete Copy Tasks

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: 'Get Incomplete Copy Tasks'
  description: 'Retrieve a list of active or pending file copy tasks.'
  version: 1.0.0
paths:
  /api/task/copy/undone:
    get:
      summary: Get incomplete copy tasks
      deprecated: false
      description: Retrieve the list of currently running or queued copy tasks.
      operationId: getTaskCopyUndone
      tags:
        - Task Management
      parameters: []
      responses:
        '200':
          description: Successful retrieval
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskResponse'
          headers: {}
          x-apifox-name: 成功
      security:
        - BearerAuth: []
      x-apifox-folder: Task Management
      x-apifox-status: released
components:
  schemas:
    TaskResponse:
      type: object
      required:
        - code
        - message
        - data
      properties:
        code:
          type: integer
          description: HTTP status code equivalent
          example: 200
        message:
          type: string
          description: Response message
          example: success
        data:
          type: array
          description: List of active task objects
          items:
            $ref: '#/components/schemas/TaskObject'
      x-apifox-orders:
        - code
        - message
        - data
    TaskObject:
      type: object
      properties:
        id:
          type: string
          description: Unique task ID
          example: "vEv3MaRtInWsD89-6CheN"
        name:
          type: string
          description: Description of the copy operation
          example: "copy [/D](/path/source.ts) to [/C](/path/dest)"
        creator:
          type: string
          description: Username of the task creator
          example: "Admin"
        creator_role:
          type: integer
          description: Role ID of the creator
          example: 0
        state:
          type: integer
          description: Numeric state of the task (e.g., 1 for running, 0 for queued)
          example: 1
        status:
          type: string
          description: Text status of the task
          example: "uploading"
        progress:
          type: number
          description: Progress percentage (0-100)
          example: 53.61933716475848
        start_time:
          type: string
          format: date-time
          description: Task start timestamp (nullable if not started)
          nullable: true
          example: "2026-01-01T12:00:00.909368+08:00"
        end_time:
          type: string
          format: date-time
          description: Task completion timestamp (usually null for undone tasks)
          nullable: true
          example: null
        total_bytes:
          type: integer
          description: Total size of files processed/to be processed in bytes
          example: 55045836
        error:
          type: string
          description: Error message if any
          example: ""
      x-apifox-orders:
        - id
        - name
        - creator
        - creator_role
        - state
        - status
        - progress
        - start_time
        - end_time
        - total_bytes
        - error
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        JWT token required for authentication.
```