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

# Comenzar consulta

> Comenza una nueva consulta médica. Retorna los IDs necesarios para enviar los chunks de audio.



## OpenAPI

````yaml docs/es/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: Comenzar consulta
      description: >-
        Comenza una nueva consulta médica. Retorna los IDs necesarios para
        enviar los chunks de audio.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                professionalId:
                  type: string
                  description: ID del profesional
                  example: 123456
                metadata:
                  type: object
                  description: Metadatos adicionales de la consulta
                  example:
                    patient_id: '123456'
                    attendance_id: '123456'
                reason:
                  type: string
                  description: Motivo de la consulta
                  example: ''
                notes:
                  type: string
                  description: Anotaciones adicionales
                  example: ''
              required:
                - professionalId
      responses:
        '201':
          description: Consulta creada con éxito
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: ID de la consulta
                    example: d3rqusph8u84z5n5d0ktbdjo
                  transcription:
                    type: string
                    description: Transcripción de la consulta
                    example: ''
                  recording:
                    type: object
                    description: Informaciones de la grabación
                    properties:
                      id:
                        type: string
                        description: ID de la grabación
                        example: xg9nwsq70bu2hjdxz7fq1q4w
                  report:
                    type: object
                    description: Reporte de la 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: Error de validación
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: array
                    description: Lista de mensajes de error de validación
                    items:
                      type: string
                    example:
                      - metadata must be an object
                  error:
                    type: string
                    description: Tipo del error
                    example: Unprocessable Entity
                  statusCode:
                    type: integer
                    description: Código del status HTTP
                    example: 422
                required:
                  - message
                  - error
                  - statusCode
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-daai-api-key
      description: Clave de API para autenticación

````