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

# Consultar estado de exportación de monitores



## OpenAPI

````yaml /es/docs-openapi.json get /v1/monitor-exports/{id}
openapi: 3.1.0
info:
  title: API REST de Zelto
  version: v1
  description: >-
    Acceso programático a tu organización de Zelto. Cada endpoint está limitado
    a la organización a la que pertenece la clave de API. Crea una clave en
    Configuración → Integraciones → Integración por API.
servers:
  - url: https://api.zelto.ai
    description: Producción
security:
  - bearerAuth: []
tags:
  - name: Monitors
    description: Exportaciones filtradas y asíncronas de resultados guardados de monitores.
  - name: Agentes
    description: >-
      Agentes de IA de voz y texto normalizados mediante el flujo de ingestión
      de Zelto.
  - name: Conversaciones
    description: >-
      Conversaciones de voz y texto (llamadas, chats y mensajes de voz), junto
      con sus transcripciones y grabaciones.
  - name: Métricas del cliente
    description: >-
      Evaluaciones proporcionadas por el cliente y asociadas a una conversación.
      Requiere que las métricas estén habilitadas.
  - name: Revisiones
    description: Estado de revisión humana de las conversaciones.
  - name: Colas de revisión
    description: Agrupa y dirige conversaciones para revisarlas por lotes.
  - name: Empresas
    description: Clientes o marcas para los que trabajan tus agentes, y sus logos.
  - name: Hallazgos
    description: >-
      Problemas estructurados descubiertos durante el análisis, con
      conversaciones y comentarios opcionales.
  - name: Experimentos
    description: >-
      Medición prospectiva de dos versiones de prompt enrutadas externamente
      mediante resultados de monitores independientes.
  - name: Organizaciones
    description: >-
      Aprovisionamiento de organizaciones sin interfaz. Requiere una clave de
      API de administrador o servicio.
paths:
  /v1/monitor-exports/{id}:
    get:
      tags:
        - Monitors
      summary: Consultar estado de exportación de monitores
      operationId: getMonitorExport
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Manifiesto actual sin claves privadas de almacenamiento.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MonitorExport'
        '400':
          description: Solicitud o filtros inválidos.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: API key ausente, vencida, revocada o no autorizada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Se requiere acceso a Monitores.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Exportación o recurso no encontrado en la organización autenticada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Exportaciones deshabilitadas o temporalmente no disponibles.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    MonitorExport:
      type: object
      required:
        - id
        - operationId
        - status
        - config
        - downloadPath
      properties:
        id:
          type: string
          format: uuid
        operationId:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - pending
            - processing
            - completed
            - failed
            - expired
        config:
          $ref: '#/components/schemas/MonitorExportConfig'
        createdAt:
          type: string
          format: date-time
        completedAt:
          type:
            - string
            - 'null'
          format: date-time
        expiresAt:
          type:
            - string
            - 'null'
          format: date-time
        rowCount:
          type:
            - integer
            - 'null'
        bytes:
          type:
            - integer
            - 'null'
        errorCode:
          type:
            - string
            - 'null'
        downloadPath:
          type:
            - string
            - 'null'
          description: >-
            Ruta de descarga autenticada en el mismo origen de la API cuando
            termina; null en otro caso.
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: >-
            Mensaje de error legible por humanos, por ejemplo, no autorizado o
            validación fallida.
        message:
          type: string
        details:
          type: object
          additionalProperties: true
    MonitorExportConfig:
      type: object
      additionalProperties: false
      required:
        - monitors
        - since
        - until
        - timezone
      properties:
        monitors:
          type: array
          minItems: 1
          maxItems: 20
          items:
            type: object
            additionalProperties: false
            required:
              - id
            properties:
              id:
                type: string
                format: uuid
              result:
                type: string
                enum:
                  - all
                  - affected
                  - not_affected
                default: all
        since:
          type: string
          format: date-time
          description: >-
            Inicio inclusivo por fecha de llamada; incluye un desplazamiento
            UTC.
        until:
          type: string
          format: date-time
          description: Fin exclusivo por fecha de llamada, posterior a since.
        timezone:
          type: string
          maxLength: 64
          example: America/Montevideo
          description: Zona horaria IANA válida. Los archivos usan timestamps UTC.
        versionScope:
          type: string
          enum:
            - historical
            - current
          default: historical
          description: >-
            Incluye versiones históricas guardadas o solo las vigentes al
            iniciar la generación. No es un historial de revisiones de
            evaluaciones.
        format:
          type: string
          enum:
            - csv
            - xlsx
            - parquet
          default: csv
        reasoning:
          type: boolean
          default: false
        match:
          type: string
          enum:
            - all
            - any
          default: all
          description: >-
            Combina condiciones explícitas por monitor. Los resultados ausentes
            o sin puntuar no cumplen condiciones positivas ni negativas.
        companyId:
          type: string
          format: uuid
        agentId:
          type: string
          format: uuid
        groupId:
          type: string
          format: uuid
        metadata:
          type: array
          maxItems: 8
          default: []
          items:
            type: object
            additionalProperties: false
            required:
              - key
              - op
            properties:
              key:
                type: string
                maxLength: 120
              op:
                type: string
                enum:
                  - eq
                  - neq
                  - contains
                  - not_contains
                  - gt
                  - gte
                  - lt
                  - lte
                  - is_set
                  - is_not_set
                  - is_true
                  - is_false
              value:
                type: string
                maxLength: 500
          description: >-
            Condiciones sobre metadatos de conversación combinadas con AND. Las
            comparaciones requieren value.
        notificationEndpointId:
          type: string
          format: uuid
          description: >-
            Destino opcional de webhook de exportaciones, activo y aprobado por
            un administrador de la organización. Requiere la función habilitada
            y membresía vigente del creador.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Envía `Authorization: Bearer YOUR_API_KEY`. La clave corresponde a una
        sola organización.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.