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

# Update Watch Rules

> Requires active Pro and an owner-scoped REST bearer key. Required scopes: watchlists:write. Changes future event matching or pauses/resumes this owned watchlist. At least one field is required. Insurance event types additionally require insurance:read and insurance availability.



## OpenAPI

````yaml /openapi.json patch /watchlists/{id}/rules
openapi: 3.1.1
info:
  title: TruckerFetch Pro API
  version: 1.0.0
  description: >-
    Owner-scoped carrier, authority and observed-insurance research. All data
    operations require active Pro. Additional scopes, historical grants, source
    availability and current suppressions apply. Source observation, effective
    dates, edition dates and renewal estimates represent distinct facts.
servers:
  - url: https://truckerfetch.com/api/v1
security: []
paths:
  /watchlists/{id}/rules:
    patch:
      summary: Update Watch Rules
      description: >-
        Requires active Pro and an owner-scoped REST bearer key. Required
        scopes: watchlists:write. Changes future event matching or
        pauses/resumes this owned watchlist. At least one field is required.
        Insurance event types additionally require insurance:read and insurance
        availability.
      operationId: updateWatchRules
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              properties:
                paused:
                  type: boolean
                event_types:
                  maxItems: 24
                  type: array
                  items:
                    type: string
                    enum:
                      - first_observed
                      - contact_changed
                      - equipment_changed
                      - census_status_changed
                      - profile_changed
                      - census_reactivated
                      - reappeared
                      - carrier.observed
                      - carrier.source_removed
                      - authhist.observed
                      - authhist.source_removed
                      - revokesuspend.observed
                      - revokesuspend.source_removed
                      - authority.pending_application
                      - authority.granted
                      - authority.suspended
                      - authority.reinstated
                      - authority.revoked
                      - authority.denied
                      - authority.withdrawn
                      - insur.observed
                      - insur.source_removed
                      - inshist.observed
                      - inshist.source_removed
              additionalProperties: false
              minProperties: 1
      responses:
        '200':
          description: Authorized operation result
          headers:
            X-Request-Id:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                properties:
                  data: {}
                  meta:
                    type: object
                  next_cursor:
                    type: string
        '400':
          description: Invalid request
        '401':
          description: Credential required
        '402':
          description: Active Pro required
        '403':
          description: Insufficient scope or allowance
        '404':
          description: Unknown or inaccessible resource
        '409':
          description: >-
            Idempotency conflict, changed projection or owner confirmation
            required
        '410':
          description: >-
            Expired cursor, artifact or dated edition outside the rolling 90-day
            Lead History window (archive_expired); the latest published edition
            remains available
        '429':
          description: Request limit exceeded
          headers:
            Retry-After:
              schema:
                type: string
        '503':
          description: Service or binding unavailable
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: Owner-scoped Pro API key

````

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