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

# Iniciar consulta

> Inicia uma nova consulta médica. Retorna os IDs necessários para enviar os chunks de áudio.



## OpenAPI

````yaml docs/pt-br/openapi.yaml post /consultations/v2
openapi: 3.1.0
info:
  title: DAAI - APIS
  version: 1.0.0
servers:
  - url: https://apim.doctorassistant.ai/api/sandbox
security:
  - ApiKeyAuth: []
tags:
  - name: Consultations
  - name: Exams
  - name: Summaries
paths:
  /consultations/v2:
    post:
      tags:
        - Consultations
      summary: Iniciar consulta
      description: >-
        Inicia uma nova consulta médica. Retorna os IDs necessários para enviar
        os chunks de áudio.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                professionalId:
                  type: string
                  description: ID do profissional
                  example: 123456
                metadata:
                  type: object
                  description: Metadados adicionais da consulta
                  example:
                    patient_id: '123456'
                    attendance_id: '123456'
                reason:
                  type: string
                  description: Motivo da consulta
                  example: ''
                notes:
                  type: string
                  description: Anotações adicionais
                  example: ''
              required:
                - professionalId
      responses:
        '201':
          description: Consulta criada com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: ID da consulta
                    example: d3rqusph8u84z5n5d0ktbdjo
                  transcription:
                    type: string
                    description: Transcrição da consulta
                    example: ''
                  recording:
                    type: object
                    description: Informações da gravação
                    properties:
                      id:
                        type: string
                        description: ID da gravação
                        example: xg9nwsq70bu2hjdxz7fq1q4w
                  report:
                    type: object
                    description: Relatório da consulta
                    example: {}
                required:
                  - id
                  - recording
        '401':
          description: Não autorizado
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Unauthorized
                  statusCode:
                    type: integer
                    example: 401
                required:
                  - message
                  - statusCode
        '422':
          description: Erro de validação
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: array
                    description: Lista de mensagens de erro de validação
                    items:
                      type: string
                    example:
                      - metadata must be an object
                  error:
                    type: string
                    description: Tipo do erro
                    example: Unprocessable Entity
                  statusCode:
                    type: integer
                    description: Código do status HTTP
                    example: 422
                required:
                  - message
                  - error
                  - statusCode
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-daai-api-key
      description: Chave de API para autenticação

````