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

# Listar tasks

> Exige `projectId`. Filtros por sprint, backlog, status, prioridade, responsável, time, board e busca.



## OpenAPI

````yaml /openapi.json get /api/v1/tasks
openapi: 3.0.0
info:
  title: WiseDesk API
  description: >-
    API REST pública do WiseDesk: tickets, cadastros, base de conhecimento,
    Agile e analytics.


    Autentique enviando a API key no header `X-API-Key` (ou `Authorization:
    Bearer wd_live_...`).

    Cada key tem escopos — rotas fora dos escopos retornam `403
    insufficient_scope`:


    - `tickets:read` — Ler tickets, mensagens, comentários, anexos e histórico

    - `tickets:write` — Criar e atualizar tickets, responder e comentar

    - `customers:read` — Ler clientes, departamentos e clientes finais

    - `customers:write` — Criar e atualizar clientes, departamentos e clientes
    finais

    - `kb:read` — Ler artigos da base de conhecimento

    - `kb:write` — Criar e atualizar artigos da base de conhecimento

    - `agile:read` — Ler projetos, sprints, boards, épicos e tasks

    - `agile:write` — Criar e atualizar sprints, boards, épicos e tasks

    - `analytics:read` — Ler dashboards e métricas (tickets e agile)


    Limite de requisições por key (padrão 120/min), informado nos headers
    `X-RateLimit-*`.
  version: '1.0'
  contact: {}
servers:
  - url: https://wisedesk-api.wiseapp360.com
    description: Produção
security: []
tags: []
paths:
  /api/v1/tasks:
    get:
      tags:
        - Agile · Tasks
      summary: Listar tasks
      description: >-
        Exige `projectId`. Filtros por sprint, backlog, status, prioridade,
        responsável, time, board e busca.
      operationId: Tasks_list
      parameters:
        - name: projectId
          required: true
          in: query
          description: ID do projeto
          schema:
            type: string
        - name: sprintId
          required: false
          in: query
          description: Somente tasks desta sprint
          schema:
            type: string
        - name: backlog
          required: false
          in: query
          description: '"true" = somente backlog (sem sprint)'
          schema:
            enum:
              - 'true'
              - 'false'
            type: string
        - name: status
          required: false
          in: query
          schema:
            type: string
            enum:
              - todo
              - in_progress
              - in_review
              - done
        - name: priority
          required: false
          in: query
          schema:
            type: string
            enum:
              - urgent
              - high
              - medium
              - low
        - name: assigneeId
          required: false
          in: query
          description: Responsável (UserProfile.id)
          schema:
            type: string
        - name: teamId
          required: false
          in: query
          schema:
            type: string
        - name: boardId
          required: false
          in: query
          description: Somente tasks de um kanban específico
          schema:
            type: string
        - name: clientId
          required: false
          in: query
          schema:
            type: string
        - name: search
          required: false
          in: query
          description: Busca por código, título ou descrição
          schema:
            type: string
        - name: includeArchived
          required: false
          in: query
          description: '"true" = inclui arquivadas'
          schema:
            enum:
              - 'true'
              - 'false'
            type: string
      responses:
        '200':
          description: ''
        '401':
          description: API key ausente, inválida, expirada ou revogada
        '403':
          description: >-
            API key sem o escopo exigido, ou company sem o ambiente Agile
            habilitado
        '429':
          description: Limite de requisições por minuto da key excedido
      security:
        - api-key: []
components:
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key no formato wd_live_...

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.