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

# Pausar Monitor

> Pausa un monitor desactivando futuras ejecuciones programadas.



## OpenAPI

````yaml es/openapi/monitors.json POST /v1/monitors/{monitor_id}/pause
openapi: 3.0.3
info:
  title: API de Monitores
  version: 1.0.0
servers:
  - url: https://api.olostep.com
security: []
paths:
  /v1/monitors/{monitor_id}/pause:
    post:
      summary: Pausar Monitor
      description: >-
        Desactiva el horario del monitor y establece `status` en `paused`. Solo
        los monitores `active` pueden ser pausados.
      parameters:
        - name: monitor_id
          in: path
          required: true
          schema:
            type: string
            pattern: ^monitor_
      responses:
        '200':
          description: Monitor pausado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Monitor'
        '400':
          description: Solicitud inválida.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Clave API inválida.
        '404':
          description: Monitor no encontrado.
        '409':
          description: Falta el horario o el monitor ya no está activo.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Error interno del servidor.
      security:
        - Authorization: []
components:
  schemas:
    Monitor:
      type: object
      properties:
        id:
          type: string
          description: Identificador único del monitor (`monitor_…`).
        object:
          type: string
          example: monitor
        query:
          type: string
          description: Intención de monitoreo en lenguaje natural.
        tracked:
          $ref: '#/components/schemas/MonitorTracked'
        source_policy:
          $ref: '#/components/schemas/MonitorSourcePolicy'
        schedule:
          $ref: '#/components/schemas/MonitorSchedule'
        notification:
          $ref: '#/components/schemas/MonitorNotification'
        webhook:
          allOf:
            - $ref: '#/components/schemas/MonitorWebhook'
          nullable: true
        output_schema:
          type: object
          additionalProperties: true
          nullable: true
          description: Esquema JSON opcional para la salida de extracción estructurada.
        status:
          type: string
          enum:
            - provisioning
            - active
            - paused
            - failed
            - deleted
          description: Monitorea el estado del ciclo de vida.
        error_message:
          type: string
          nullable: true
          description: Presente cuando `status` es `failed`.
        last_run:
          allOf:
            - $ref: '#/components/schemas/MonitorLastRun'
          nullable: true
          description: >-
            Resumen de la última instantánea. Incluido en `GET
            /v1/monitors/{monitor_id}`.
        agent:
          $ref: '#/components/schemas/MonitorAgent'
        metadata:
          type: object
          additionalProperties: true
        created:
          type: integer
          description: Marca de tiempo Unix (segundos).
        updated:
          type: integer
          description: Marca de tiempo Unix (segundos).
        total_count:
          type: integer
          description: >-
            Conteo total de instantáneas. Incluido en `GET
            /v1/monitors/{monitor_id}` a menos que `include_total_count=false`.
        mermaid_diagram:
          type: string
          description: >-
            Diagrama de flujo Mermaid del monitor DAG. Incluido cuando
            `include-diagram=true` en get.
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        monitor_id:
          type: string
          description: Presente en algunas respuestas de error de creación/actualización.
    MonitorTracked:
      type: object
      description: >-
        Objetivos resueltos que el monitor rastrea después de que se completa la
        planificación.
      properties:
        type:
          type: string
          nullable: true
          description: Tipo de superficie rastreada (por ejemplo, `url` o `web_query`).
        urls:
          type: array
          items:
            type: string
            format: uri
          description: URLs concretas que se están monitoreando.
        web_query:
          type: string
          nullable: true
          description: >-
            Consulta de búsqueda web utilizada cuando el monitor rastrea un
            conjunto de resultados dinámico.
    MonitorSourcePolicy:
      type: object
      description: >-
        Listas de permitidos y denegados de URL/dominio opcionales aplicadas
        durante la planificación y ejecución.
      properties:
        include_urls:
          type: array
          items:
            type: string
            format: uri
        exclude_urls:
          type: array
          items:
            type: string
            format: uri
        include_domains:
          type: array
          items:
            type: string
        exclude_domains:
          type: array
          items:
            type: string
    MonitorSchedule:
      type: object
      properties:
        frequency:
          type: string
          nullable: true
          description: >-
            Texto de programación en lenguaje natural (por ejemplo, `every
            hour`).
        cron:
          type: string
          nullable: true
          description: Expresión Cron derivada de `frequency`.
        timezone:
          type: string
          example: UTC
          description: >-
            Zona horaria de la programación. Actualmente `UTC` para las
            programaciones de monitores.
        next_run_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Próxima ejecución programada (ISO 8601). `null` cuando el monitor no
            está `active`.
    MonitorNotification:
      type: object
      properties:
        events:
          type: array
          items:
            type: string
            enum:
              - changed
              - first_snapshot
          description: >-
            Cuándo notificar. `changed` — entregar cuando se detecta un cambio
            en comparación con la instantánea anterior. `first_snapshot` —
            entregar cuando se toma la primera instantánea de referencia. Por
            defecto, ambos cuando `channels` no está vacío y `events` está
            vacío.
        channels:
          type: array
          items:
            $ref: '#/components/schemas/NotificationChannel'
          description: >-
            Objetivos de entrega de Email, Slack o SMS. Resueltos en tiempo de
            ejecución por el pipeline del monitor.
    MonitorWebhook:
      type: object
      required:
        - url
      properties:
        url:
          type: string
          format: uri
          description: >-
            URL HTTP/HTTPS que recibe las cargas útiles del monitor (separado de
            `notification.channels`).
    MonitorLastRun:
      type: object
      properties:
        id:
          type: string
          nullable: true
          description: ID de ejecución de la última instantánea (`run_…`).
        status:
          type: string
          example: completed
        change_detected:
          type: boolean
          nullable: true
        ran_at:
          type: string
          format: date-time
          nullable: true
    MonitorAgent:
      type: object
      properties:
        id:
          type: string
          nullable: true
          description: >-
            ID de agente sombra interno utilizado para ejecutar el DAG del
            monitor.
    NotificationChannel:
      type: object
      required:
        - type
        - target
      properties:
        type:
          type: string
          enum:
            - email
            - slack
            - sms
          description: Tipo de canal de entrega.
        target:
          type: string
          description: >-
            Dirección de correo electrónico, URL de webhook de Slack, o número
            de teléfono E.164 (para SMS).
        events:
          type: array
          items:
            type: string
            enum:
              - changed
              - first_snapshot
          description: >-
            Filtro de eventos opcional por canal. Cuando se omite, la entrega
            del canal sigue `notification.events` a nivel superior (o los
            valores predeterminados cuando se configuran canales).
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer
      description: >-
        Encabezado de autenticación Bearer de la forma Bearer <token>, donde
        <token> es tu token de autenticación.

````