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

# Terminar consulta

> Termina la consulta e inicia el procesamiento del audio. La especialidad puede ser especificada para determinar el template del reporte.



## OpenAPI

````yaml docs/es/openapi.yaml post /consultations/v2/{DAAI_CONSULTATION_ID}/recordings/{DAAI_RECORDING_ID}/finish
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/{DAAI_CONSULTATION_ID}/recordings/{DAAI_RECORDING_ID}/finish:
    post:
      tags:
        - Consultations
      summary: Terminar consulta
      description: >-
        Termina la consulta e inicia el procesamiento del audio. La especialidad
        puede ser especificada para determinar el template del reporte.
      parameters:
        - name: DAAI_CONSULTATION_ID
          in: path
          schema:
            type: string
          required: true
        - name: DAAI_RECORDING_ID
          in: path
          schema:
            type: string
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                specialty:
                  type: string
                  description: >-
                    Especialidad de la consulta. Si no informada, será
                    considerada como 'generic'
                  default: generic
                  example: generic
                reportSchema:
                  type: object
                  description: >
                    Esquema do relatório. Se não informado, será considerado o
                    esquema padrão da especialidade ou o configurado
                    globalmente.


                    - O campo `schema` deve ser um **JSON Schema válido**,
                    conforme a [especificação
                    oficial](https://json-schema.org/specification). Isso
                    garante que o relatório gerado siga a estrutura esperada.

                    - O campo `fewShots` deve conter exemplos que **satisfazem o
                    schema definido**.


                    > **Dica:** É possível testar e validar a configuração do
                    relatório customizado diretamente no backoffice, na aba de
                    transformação nas configurações da aplicação. Assim, você
                    pode experimentar diferentes schemas e exemplos antes de
                    aplicar em produção.
                  properties:
                    instructions:
                      type: string
                      description: Instruções para geração do relatório
                      example: >-
                        O relatório deve ser escrito em português brasileiro e
                        deve conter as informações do paciente, da consulta e do
                        diagnóstico.
                    schema:
                      type: object
                      description: Schema JSON do conteúdo do relatório
                      properties:
                        type:
                          type: string
                          example: object
                        required:
                          type: array
                          items:
                            type: string
                        properties:
                          type: object
                          additionalProperties: true
                        additionalProperties:
                          type: boolean
                      required:
                        - type
                        - required
                        - properties
                        - additionalProperties
                    fewShots:
                      type: string
                      description: >-
                        Exemplos de preenchimento do relatório em formato JSON
                        string
                      example: '[{"foo":1,"bar":"test"},{"foo":2,"bar":"test2"}]'
                  required:
                    - instructions
                    - schema
      responses:
        '201':
          description: Consulta finalizada com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: ID da consulta
                    example: s0q0ud3fi1d9kcwjrt8vs50n
                  transcription:
                    type: string
                    description: Transcrição da consulta
                    example: ''
                  recording:
                    type: object
                    description: Informações da gravação
                    example: {}
                  report:
                    type: object
                    description: Relatório da consulta
                    properties:
                      specialty:
                        type: string
                        description: Especialidade da consulta
                        example: generic
                      content:
                        type: object
                        description: Conteúdo do relatório
                        example: {}
                  metadata:
                    type: object
                    description: Metadados da consulta
                    example: {}
                required:
                  - id
                  - transcription
                  - recording
                  - report
                  - metadata
        '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
        '404':
          description: Consulta não encontrada
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Mensagem de erro
                    example: Consultation not found
                  error:
                    type: string
                    description: Tipo do erro
                    example: Not Found
                  statusCode:
                    type: integer
                    description: Código do status HTTP
                    example: 404
                required:
                  - message
                  - error
                  - 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:
                      - specialty must be a string
                  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: Clave de API para autenticación

````