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

# List tasks

> Get a project's board: its columns, each with the tasks in it, plus the archived and planned buckets. Filter and paginate with the query parameters.



## OpenAPI

````yaml /openapi.json get /task/tasks/{projectId}
openapi: 3.1.0
info:
  title: Kaneo API
  version: 1.0.0
  description: Kaneo Project Management API - Manage projects, tasks, labels, and more
servers:
  - url: https://cloud.kaneo.app/api
    description: Kaneo API Server
security:
  - bearerAuth: []
paths:
  /task/tasks/{projectId}:
    get:
      tags:
        - Tasks
      summary: List tasks
      description: >-
        Get a project's board: its columns, each with the tasks in it, plus the
        archived and planned buckets. Filter and paginate with the query
        parameters.
      operationId: listTasks
      parameters:
        - schema:
            type: string
          required: true
          name: projectId
          in: path
        - schema:
            type: string
          required: false
          name: status
          in: query
        - schema:
            type: string
          required: false
          name: priority
          in: query
        - schema:
            type: string
          required: false
          name: assigneeId
          in: query
        - schema:
            type: string
            pattern: ^\d+$
          required: false
          name: page
          in: query
        - schema:
            type: string
            pattern: ^\d+$
          required: false
          name: limit
          in: query
        - schema:
            type: string
            enum:
              - createdAt
              - priority
              - dueDate
              - position
              - title
              - number
          required: false
          name: sortBy
          in: query
        - schema:
            type: string
            enum:
              - asc
              - desc
          required: false
          name: sortOrder
          in: query
        - schema:
            type: string
          required: false
          name: dueBefore
          in: query
        - schema:
            type: string
          required: false
          name: dueAfter
          in: query
      responses:
        '200':
          description: The project board
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BoardResponse'
        '400':
          description: Unknown project, or its workspace could not be determined
          content:
            text/plain:
              schema:
                type: string
        '401':
          description: Missing or invalid credentials
        '403':
          description: No access to the project's workspace
          content:
            text/plain:
              schema:
                type: string
components:
  schemas:
    BoardResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/Board'
        pagination:
          $ref: '#/components/schemas/BoardPagination'
      required:
        - data
        - pagination
    Board:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        slug:
          type: string
        icon:
          type:
            - string
            - 'null'
        description:
          type:
            - string
            - 'null'
        isPublic:
          type:
            - boolean
            - 'null'
        workspaceId:
          type: string
        columns:
          type: array
          items:
            $ref: '#/components/schemas/BoardColumn'
        archivedTasks:
          type: array
          items:
            $ref: '#/components/schemas/BoardTask'
        plannedTasks:
          type: array
          items:
            $ref: '#/components/schemas/BoardTask'
      required:
        - id
        - name
        - slug
        - icon
        - description
        - isPublic
        - workspaceId
        - columns
        - archivedTasks
        - plannedTasks
    BoardPagination:
      type: object
      properties:
        total:
          type: number
        page:
          type: number
        pageSize:
          type: number
        totalPages:
          type: number
      required:
        - total
        - page
        - pageSize
        - totalPages
      description: When no page/limit is given, everything is returned on a single page.
    BoardColumn:
      type: object
      properties:
        id:
          type: string
          description: The column slug, same as `slug`.
        slug:
          type: string
        name:
          type: string
        icon:
          type:
            - string
            - 'null'
        isFinal:
          type: boolean
        tasks:
          type: array
          items:
            $ref: '#/components/schemas/BoardTask'
      required:
        - id
        - slug
        - name
        - icon
        - isFinal
        - tasks
    BoardTask:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        number:
          type:
            - number
            - 'null'
        description:
          type:
            - string
            - 'null'
        status:
          type: string
        priority:
          type: string
          description: 'One of: no-priority, low, medium, high, urgent.'
        startDate:
          type:
            - string
            - 'null'
          format: date-time
        dueDate:
          type:
            - string
            - 'null'
          format: date-time
        position:
          type:
            - number
            - 'null'
        createdAt:
          type: string
          format: date-time
        userId:
          type:
            - string
            - 'null'
        assigneeName:
          type:
            - string
            - 'null'
        assigneeId:
          type:
            - string
            - 'null'
        assigneeImage:
          type:
            - string
            - 'null'
        projectId:
          type: string
        labels:
          type: array
          items:
            $ref: '#/components/schemas/TaskLabel'
        externalLinks:
          type: array
          items:
            $ref: '#/components/schemas/TaskExternalLink'
      required:
        - id
        - title
        - number
        - description
        - status
        - priority
        - startDate
        - dueDate
        - position
        - createdAt
        - userId
        - assigneeName
        - assigneeId
        - assigneeImage
        - projectId
        - labels
        - externalLinks
    TaskLabel:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        color:
          type: string
      required:
        - id
        - name
        - color
    TaskExternalLink:
      type: object
      properties:
        id:
          type: string
        taskId:
          type: string
        integrationId:
          type: string
        resourceType:
          type: string
        externalId:
          type: string
        url:
          type: string
        title:
          type:
            - string
            - 'null'
        metadata:
          type:
            - object
            - 'null'
          additionalProperties: {}
          description: >-
            Provider-specific payload, already parsed from the stored JSON
            string.
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
      required:
        - id
        - taskId
        - integrationId
        - resourceType
        - externalId
        - url
        - title
        - metadata
        - createdAt
        - updatedAt
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key or session token (Bearer)

````