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

# Update Monitor

> Update an existing monitor's configuration and detection rules.



## OpenAPI

````yaml en-openapi POST /monitors/update
openapi: 3.0.0
info:
  description: >-
    The Pubrio API is used to search, preview and enrich Contacts and Accounts.
    Pubrio database provides extensive B2B contacts and sales intelligence data.
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/en/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/en/get-in-touch
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://api.pubrio.com
security:
  - pubrio_api_key: []
tags:
  - name: Profile
    description: Workspace profile information and usage statistics
  - name: Enrichment
    description: Enrich people and company records with detailed B2B data
  - name: Lookalike
    description: Find companies similar to a given company
  - name: Search
    description: Search for people, companies, jobs, news, and advertisements with filters
  - name: Lookup
    description: >-
      Look up detailed information for specific people, companies, jobs, news,
      advertisements, and technologies
  - name: LinkedIn
    description: Look up people and company data via LinkedIn profile URLs
  - name: Redeem
    description: Redeem credits to unlock people contact details (single and batch)
  - name: Channels
    description: Manage outreach channel templates (create, update, delete, list)
  - name: Monitor
    description: Create and manage data monitors with webhooks, statistics, and processing
  - name: Filters
    description: >-
      Retrieve available filter values for search parameters (technologies,
      locations, verticals, etc.)
externalDocs:
  description: >-
    The Pubrio API is used to search, preview and enrich Contacts and Accounts.
    Pubrio database provides extensive B2B contacts and sales intelligence data.
  url: https://docs.pubrio.com
paths:
  /monitors/update:
    post:
      tags:
        - Monitor
      summary: Update a monitor
      description: Update an existing monitor's configuration and detection rules.
      operationId: monitors_update
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                monitor_id:
                  type: string
                  format: uuid
                  description: Unique identifier of the monitor to update.
                name:
                  type: string
                  description: Name of the monitor.
                description:
                  type: string
                  description: Description of the monitor.
                detection_mode:
                  type: string
                  description: Detection mode.
                  enum:
                    - company_first
                    - signal_first
                signal_types:
                  type: array
                  items:
                    type: string
                    enum:
                      - jobs
                      - news
                      - advertisements
                  description: Types of signals to monitor.
                signal_filters:
                  type: array
                  items:
                    type: object
                  description: >-
                    Array of signal filter objects. Each object has
                    `signal_type` (one of: jobs, news, advertisements) and
                    `filters` (object with signal-specific parameters). See [Job
                    Search](/en/api-reference/endpoint/companies/job_search),
                    [News
                    Search](/en/api-reference/endpoint/companies/news_search),
                    or [Advertisement
                    Search](/en/api-reference/endpoint/companies/advertisements_search)
                    for available filter parameters per signal type.
                  example:
                    - filters:
                        locations:
                          - US
                      signal_type: jobs
                    - filters:
                        locations:
                          - US
                      signal_type: news
                    - filters:
                        target_locations:
                          - US
                      signal_type: advertisements
                company_filters:
                  type: object
                  description: >-
                    Global company filters applied as a second layer across all
                    signal types. Accepts the same parameters as the [Company
                    Search](/en/api-reference/endpoint/companies/search)
                    endpoint — locations, employees, technologies, verticals,
                    industries, and more.
                  example:
                    locations:
                      - US
                    employees:
                      - - 501
                        - 1000
                      - - 1001
                        - 5000
                companies:
                  type: array
                  items:
                    type: string
                    format: uuid
                  description: >-
                    List of company domain_search_id UUIDs. Alternative: use
                    `domains` or `linkedin_urls`.
                domains:
                  type: array
                  items:
                    type: string
                  description: List of company domains. Alternative to `companies`.
                linkedin_urls:
                  type: array
                  items:
                    type: string
                    format: uri
                  description: List of LinkedIn company URLs. Alternative to `companies`.
                is_company_enrichment:
                  type: boolean
                  description: Whether to enrich company data.
                is_people_enrichment:
                  type: boolean
                  description: Whether to enrich people data.
                people_enrichment_configs:
                  type: array
                  items:
                    type: object
                  description: >-
                    Array of people enrichment layers. Each layer runs an
                    independent people search. Contains `max_people_to_return`
                    (1-25), `people_contact_types` (array — refers to
                    [Redeem](/en/api-reference/endpoint/redeem/people) contact
                    types: email-work, email-personal, phone), and `filters`
                    (same parameters as [People
                    Search](/en/api-reference/endpoint/people/search) endpoint).
                  example:
                    - filters:
                        people_locations:
                          - US
                      max_people_to_return: 3
                      people_contact_types:
                        - email-work
                destination_type:
                  type: string
                  description: Delivery destination type.
                  enum:
                    - webhook
                    - email
                    - sequences
                destination_config:
                  type: object
                  description: >-
                    Configuration for the destination. For webhook: requires
                    `webhook_url` (string), optional `headers` (object) and
                    `body` (object). For email: requires `email` (string). For
                    sequences: requires `sequence_identifier` (string) and
                    `record_type` (string).
                  example:
                    webhook_url: https://your-webhook.com/endpoint
                    headers:
                      Authorization: Bearer token
                    body:
                      pipeline: my-webhook
                frequency_minute:
                  type: integer
                  description: >-
                    Trigger frequency in minutes. Min: 0, Max: 10080, Default:
                    0.
                  minimum: 0
                  maximum: 10080
                max_failure_trigger:
                  type: integer
                  description: >-
                    Maximum consecutive failures before pausing. Min: 1, Max:
                    10, Default: 5.
                  minimum: 1
                  maximum: 10
                max_daily_trigger:
                  type: integer
                  description: 'Maximum triggers per day. Min: 0, Max: 86400, Default: 500.'
                  minimum: 0
                  maximum: 86400
                max_records_per_trigger:
                  type: integer
                  description: >-
                    Controls the maximum number of records delivered per
                    trigger. Lower values reduce payload size per delivery,
                    which is recommended for large result sets or rate-limited
                    integrations. Min: 1, Max: 100, Default: 25. See [Setting up
                    Webhooks](/en/developer-guides/setting-up-webhooks) for
                    guidance.
                  minimum: 1
                  maximum: 100
                notification_email:
                  type: string
                  format: email
                  description: Email for failure notifications.
                max_retry_per_trigger:
                  type: integer
                  description: 'Maximum retries per trigger. Min: 0, Max: 3, Default: 1.'
                  minimum: 0
                  maximum: 3
                retry_delay_second:
                  type: integer
                  description: >-
                    Delay between retries in seconds. Min: 1, Max: 5, Default:
                    1.
                  minimum: 1
                  maximum: 5
                is_active:
                  type: boolean
                  description: Whether the monitor should be active.
                is_paused:
                  type: boolean
                  description: Whether the monitor should be paused.
                profile_id:
                  $ref: '#/components/schemas/profile_id'
              required:
                - monitor_id
      responses:
        '200':
          description: Successful response containing the full updated monitor object.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      monitor_id:
                        type: string
                        format: uuid
                        description: Unique identifier for the monitor.
                      name:
                        type: string
                        description: Name of the monitor.
                      description:
                        type: string
                        description: Description of the monitor.
                      detection_mode:
                        type: string
                        description: Detection mode.
                      signal_types:
                        type: array
                        items:
                          type: string
                        description: Types of signals monitored.
                      signal_filters:
                        type: object
                        description: Filters applied to signals.
                      company_filters:
                        type: object
                        description: Filters applied to companies.
                      companies:
                        type: array
                        items:
                          type: string
                        description: Company identifiers.
                      is_company_enrichment:
                        type: boolean
                        description: Whether company enrichment is enabled.
                      is_people_enrichment:
                        type: boolean
                        description: Whether people enrichment is enabled.
                      people_enrichment_configs:
                        type: object
                        description: People enrichment configuration.
                      destination_type:
                        type: string
                        description: Delivery destination type.
                      destination_config:
                        type: object
                        description: Destination configuration.
                      frequency_minute:
                        type: integer
                        description: Trigger frequency in minutes.
                      max_retry_per_trigger:
                        type: integer
                        description: Maximum retries per trigger.
                      max_records_per_trigger:
                        type: integer
                        description: Maximum records per trigger.
                      retry_delay_second:
                        type: integer
                        description: Delay between retries in seconds.
                      max_daily_trigger:
                        type: integer
                        description: Maximum triggers per day.
                      max_failure_trigger:
                        type: integer
                        description: Maximum consecutive failures before pausing.
                      masked_signature:
                        type: string
                        description: Masked webhook signature.
                      is_active:
                        type: boolean
                        description: Whether the monitor is active.
                      is_paused:
                        type: boolean
                        description: Whether the monitor is paused.
                      notification_email:
                        type: string
                        description: Notification email address.
                      last_trigger_at:
                        type: string
                        format: date-time
                        nullable: true
                        description: Timestamp of the last trigger.
                      last_processed_at:
                        type: string
                        format: date-time
                        nullable: true
                        description: Timestamp of the last completed processing.
                      created_at:
                        type: string
                        format: date-time
                        description: Timestamp when the monitor was created.
                      last_modified:
                        type: string
                        format: date-time
                        description: Timestamp when the monitor was last modified.
                      statistics:
                        type: object
                        properties:
                          total_triggers:
                            type: integer
                            description: Total triggers.
                          total_success:
                            type: integer
                            description: Total successful triggers.
                          success_rate:
                            type: number
                            description: Success rate (0 to 1).
              example:
                data:
                  monitor_id: b2c3d4e5-f6a7-8901-bcde-f12345678901
                  name: Updated Monitor Name
                  description: Updated description
                  detection_mode: company_first
                  signal_types:
                    - jobs
                    - news
                  destination_type: webhook
                  is_active: true
                  is_paused: false
                  created_at: '2026-03-15T10:00:00.000Z'
                  last_modified: '2026-04-05T21:00:00.000Z'
                  statistics:
                    total_triggers: 120
                    total_success: 118
                    success_rate: 0.983
        '400':
          $ref: '#/components/responses/general_error'
        '429':
          $ref: '#/components/responses/rate_limit_error'
        '500':
          $ref: '#/components/responses/server_error'
components:
  schemas:
    profile_id:
      type: integer
      description: >-
        Optional. An identifier for the user profile (workspace) making the
        request. This is no longer required as the API key already includes your
        workspace information. If provided, it helps in associating the lookup
        with a specific user, allowing for data retrieval and credit tracking. 

         Check out `user details` endpoints under the Profile tab for more information.
  responses:
    general_error:
      description: >-
        Bad request. The request was malformed or contained invalid parameters.
        Check the error code and message for details.
      content:
        application/json:
          schema:
            required:
              - code
              - message
              - details
            type: object
            properties:
              code:
                example: 40001
                type: integer
              message:
                example: >-
                  Errors and codes will vary depending on the scenario, please
                  see the documentation for information.
                type: string
              details:
                type: object
    rate_limit_error:
      description: >-
        Rate limit exceeded. Too many requests were made in a given time period.
        Retry after the rate limit window resets.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: Request rate limit exceeded. Please wait and try again later.
                type: string
    server_error:
      description: >-
        Internal server error. An unexpected error occurred on the server.
        Contact support if the error persists.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: An unexpected error occurred on the server.
                type: string
  securitySchemes:
    pubrio_api_key:
      type: apiKey
      name: pubrio-api-key
      description: >-
        A unique API token that represents the actions you perform through the
        API and the corresponding permissions and operations. You can create it
        through the [Settings](https://dashboard.pubrio.com/#/settings/)
        section.
      in: header

````