> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eden.art/llms.txt
> Use this file to discover all available pages before exploring further.

# List User Tasks

> Retrieve a paginated list of tasks for the authenticated user with optional filtering by status, type, or tool.



## OpenAPI

````yaml openapi.json get /v2/tasks
openapi: 3.0.0
info:
  title: '@fastify/swagger'
  description: API for Eden.art platform
  version: 8.14.0
servers:
  - url: https://api.eden.art
    description: Production server
  - url: https://api-staging.eden.art
    description: Staging server
  - url: http://localhost:8080
    description: Development server
security: []
tags:
  - name: Agent Creation
    description: Operations related to agent creation
  - name: Agents
    description: Operations related to agents
  - name: Agents - Deployments
    description: Operations related to agents - deployments
  - name: Agents - Memory
    description: Operations related to agents - memory
  - name: Agents - Triggers
    description: Operations related to agents - triggers
  - name: API Keys
    description: Operations related to api keys
  - name: Collections
    description: Operations related to collections
  - name: Concepts V2
    description: Operations related to concepts v2
  - name: Creations
    description: Operations related to creations
  - name: Creators
    description: Operations related to creators
  - name: Manna
    description: Operations related to manna
  - name: Models
    description: Operations related to models
  - name: Sessions
    description: Operations related to sessions
  - name: Sessions - Permissions
    description: Operations related to sessions - permissions
  - name: Tasks
    description: Operations related to tasks
  - name: Tools
    description: Operations related to tools
paths:
  /v2/tasks:
    get:
      tags:
        - Tasks
      summary: List User Tasks
      description: >-
        Retrieve a paginated list of tasks for the authenticated user with
        optional filtering by status, type, or tool.
      parameters:
        - required: false
          in: query
          name: status
          schema:
            type: string
        - required: false
          in: query
          name: taskId
          schema:
            type: string
        - required: false
          in: query
          name: type
          schema:
            type: string
        - required: false
          in: query
          name: output_type
          schema:
            type: string
        - required: false
          in: query
          name: cost
          schema:
            type: number
        - required: false
          in: query
          name: tool
          schema:
            type: string
        - required: false
          in: query
          name: minDate
          schema:
            type: boolean
        - required: false
          in: query
          name: page
          schema:
            type: number
        - required: false
          in: query
          name: orderBy
          schema:
            type: string
        - required: false
          in: query
          name: direction
          schema:
            type: number
        - required: false
          in: query
          name: limit
          schema:
            type: number
      responses:
        '200':
          description: Default Response
          content:
            '*/*':
              schema:
                type: object
                properties:
                  docs:
                    type: array
                    items:
                      type: object
                      properties:
                        _id:
                          type: string
                        user:
                          type: object
                          properties:
                            _id:
                              type: string
                            userId:
                              type: string
                            username:
                              type: string
                            userImage:
                              type: string
                          required:
                            - _id
                            - userId
                            - username
                            - userImage
                        agent: {}
                        tool:
                          type: string
                        cost:
                          type: number
                        output_type:
                          type: string
                        args: {}
                        status:
                          type: string
                        performance: {}
                        result: {}
                        model: {}
                        error: {}
                        progress:
                          type: number
                        updatedAt:
                          type: string
                        createdAt:
                          type: string
                      required:
                        - _id
                        - user
                        - tool
                        - args
                        - status
                  total:
                    type: number
                  limit:
                    type: number
                  pages:
                    type: number
                  page:
                    type: number
                  pagingCounter:
                    type: number
                  hasPrevPage:
                    type: boolean
                  hasNextPage:
                    type: boolean
                  prevPage:
                    type: number
                  nextPage:
                    type: number
                required:
                  - docs
                  - total
                  - limit
                  - pages
                  - page
                  - pagingCounter
                  - hasPrevPage
                  - hasNextPage
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: X-Api-Key
      in: header

````