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

> O SLA é calculado automaticamente pela política vigente.



## OpenAPI

````yaml /openapi.json post /api/v1/tickets
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/tickets:
    post:
      tags:
        - Tickets
      summary: Criar ticket
      description: O SLA é calculado automaticamente pela política vigente.
      operationId: Tickets_create
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateTicketDto'
      responses:
        '201':
          description: ''
        '401':
          description: API key ausente, inválida, expirada ou revogada
        '403':
          description: API key sem o escopo exigido (insufficient_scope)
        '429':
          description: Limite de requisições por minuto da key excedido
      security:
        - api-key: []
components:
  schemas:
    CreateTicketDto:
      type: object
      properties:
        title:
          type: string
          example: Problema com veículo em trânsito
          description: Título do ticket
        description:
          type: string
          example: O veículo apresentou problema mecânico durante a viagem
          description: Descrição detalhada do ticket
        status:
          $ref: '#/components/schemas/TicketStatus'
          example: open
        priority:
          $ref: '#/components/schemas/Priority'
          example: urgent
        client:
          type: string
          example: João da Silva
          description: Nome do cliente/motorista
        agentId:
          type: string
          example: 123e4567-e89b-12d3-a456-426614174000
          description: ID do perfil do agente (UserProfile) responsável pelo ticket
        tag:
          type: string
          example: Urgente
          description: Tag do ticket
        departamento:
          type: string
          example: '1'
          description: >-
            ID numérico do departamento (corresponde ao id da tabela
            departamento)
        companyId:
          type: string
          example: 123e4567-e89b-12d3-a456-426614174000
          description: >-
            ID da empresa do ticket. Usado apenas por superadmin (admin/agente
            herdam a empresa do próprio usuário).
        projetoId:
          type: string
          example: 123e4567-e89b-12d3-a456-426614174000
          description: >-
            ID do projeto Agile vinculado ao ticket (opcional). Deve pertencer à
            mesma empresa do ticket.
      required:
        - title
        - priority
        - client
    TicketStatus:
      type: string
      description: 'Status do ticket. Valores: open, in_progress, pending, completed'
      enum:
        - open
        - in_progress
        - pending
        - completed
    Priority:
      type: string
      description: 'Prioridade do ticket. Valores: urgent, high, medium, low'
      enum:
        - urgent
        - high
        - medium
        - low
  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.