> ## 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.

# Criar task

> O código (ex.: WD-42) é gerado automaticamente.



## OpenAPI

````yaml /openapi.json post /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:
    post:
      tags:
        - Agile · Tasks
      summary: Criar task
      description: 'O código (ex.: WD-42) é gerado automaticamente.'
      operationId: Tasks_create
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateAgileTaskDto'
      responses:
        '201':
          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:
  schemas:
    CreateAgileTaskDto:
      type: object
      properties:
        projectId:
          type: string
        title:
          type: string
        description:
          type: string
        status:
          type: string
          enum:
            - todo
            - in_progress
            - in_review
            - done
        priority:
          type: string
          enum:
            - urgent
            - high
            - medium
            - low
        sprintId:
          type: string
        assigneeId:
          type: string
          description: Responsável único (legado). Prefira assigneeIds.
        parentTaskId:
          type: string
        sourceTicketId:
          type: string
        storyPoints:
          type: number
        timeEstimateMinutes:
          type: number
          description: Estimativa em minutos
        dueDate:
          type: string
        teamIds:
          description: IDs dos times atribuídos
          type: array
          items:
            type: string
        boardIds:
          description: IDs dos kanbans onde a task entra
          type: array
          items:
            type: string
        assigneeIds:
          description: IDs dos responsáveis (N:N)
          type: array
          items:
            type: string
        clientIds:
          description: IDs dos clientes atribuídos (N:N)
          type: array
          items:
            type: string
        epicId:
          type: string
          description: Épico atribuído
      required:
        - projectId
        - title
  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.