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

# Update load balancer pool health monitor

> Updates the health monitor of a load balancer pool, such as its check intervals, timeouts,
and the thresholds used to mark pool members as healthy or unhealthy. Only the supplied
fields are changed. Returns 404 if the pool has no health monitor attached.
If a provided field already matches the current health monitor state it is skipped, and when no field
changes anything no task is created and an empty task list is returned.



## OpenAPI

````yaml /api-reference/services_docs_mintlify_enriched/cloud_api.yaml patch /cloud/v1/lbpools/{project_id}/{region_id}/{pool_id}/healthmonitor
openapi: 3.1.0
info:
  title: Gcore OpenAPI – Cloud API
  description: >-
    This OpenAPI is an aggregated OpenAPI specification that unifies all Gcore
    products into a single file. It covers Cloud, CDN, DNS, WAAP, DDoS
    Protection, Object Storage, Streaming, and FastEdge services.
  version: e4facaa17275
servers:
  - url: https://api.gcore.com
security:
  - APIKey: []
tags:
  - name: Bare Metal
  - name: Container as a Service
  - name: Cost Reports
  - name: DDoS Protection
  - name: Everywhere Inference
  - name: Everywhere Inference Apps
  - name: File Shares
  - name: Floating IPs
  - name: Function as a Service
  - name: GPU Bare Metal
  - name: GPU Virtual
  - name: IP Ranges
  - name: Images
  - name: Instances
  - name: Load Balancers
  - name: Logging
  - name: Managed Kubernetes
  - name: Managed PostgreSQL
  - name: Networks
  - name: Placement Groups
  - name: Ports
  - name: Projects
  - name: Quotas
  - name: Regions
  - name: Registry
  - name: Reservations
  - name: Reserved IPs
  - name: Routers
  - name: SSH Keys
  - name: Secrets
  - name: Security Groups
  - name: Snapshot Schedules
  - name: Snapshots
  - name: Tasks
  - name: User Actions
  - name: User Role Assignments
  - name: Volumes
paths:
  /cloud/v1/lbpools/{project_id}/{region_id}/{pool_id}/healthmonitor:
    patch:
      tags:
        - Load Balancers
      summary: Update load balancer pool health monitor
      description: >-
        Updates the health monitor of a load balancer pool, such as its check
        intervals, timeouts,

        and the thresholds used to mark pool members as healthy or unhealthy.
        Only the supplied

        fields are changed. Returns 404 if the pool has no health monitor
        attached.

        If a provided field already matches the current health monitor state it
        is skipped, and when no field

        changes anything no task is created and an empty task list is returned.
      operationId: LoadBalancerPoolInstanceHealthMonitorViewSet.patch
      parameters:
        - in: path
          name: project_id
          required: true
          description: Project ID
          schema:
            description: Project ID
            example: 1
            examples:
              - 1
            title: Project Id
            type: integer
        - in: path
          name: region_id
          required: true
          description: Region ID
          schema:
            description: Region ID
            example: 1
            examples:
              - 1
            exclusiveMinimum: 0
            title: Region Id
            type: integer
        - in: path
          name: pool_id
          required: true
          description: Pool ID
          schema:
            description: Pool ID
            example: 00000000-0000-4000-8000-000000000000
            examples:
              - 00000000-0000-4000-8000-000000000000
            format: uuid4
            title: Pool Id
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchLbHealthMonitorSerializerV2'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskIDsSerializer'
components:
  schemas:
    PatchLbHealthMonitorSerializerV2:
      properties:
        admin_state_up:
          description: >-
            Administrative state of the resource. Omit to leave unchanged;
            `false` disables the resource so it will not process traffic.
          example: true
          examples:
            - true
            - false
          title: Admin State Up
          type: boolean
        delay:
          description: >-
            The time, in seconds, between sending probes to members. Omit to
            leave unchanged.
          example: 10
          examples:
            - 10
          maximum: 2147483647
          minimum: 1
          title: Delay
          type: integer
        domain_name:
          anyOf:
            - pattern: ^[A-Za-z0-9._-]{1,253}$
              type: string
            - type: 'null'
          description: >-
            Domain name for HTTP host header. Can only be used together with
            `HTTP` or `HTTPS` health monitor type. Omit to leave unchanged. Set
            to `null` to clear the current value.
          examples:
            - example.com
          title: Domain Name
        expected_codes:
          anyOf:
            - pattern: ^(\d{3}(\s*,\s*\d{3})*)$|^(\d{3}-\d{3})$
              type: string
            - type: 'null'
          description: >-
            Expected HTTP response codes. Can be a single code, a
            comma-separated list of codes, or a single range of codes. Can only
            be used together with `HTTP` or `HTTPS` health monitor type. For
            example, 200, 200,202,401,403,404, or 200-204. Omit to leave
            unchanged. Set to `null` to clear the current value.
          examples:
            - 200,301,302
          title: Expected Codes
        http_method:
          anyOf:
            - $ref: '#/components/schemas/HttpMethodEnum'
            - type: 'null'
          description: >-
            HTTP method. Can only be used together with `HTTP` or `HTTPS` health
            monitor type. Omit to leave unchanged. Set to `null` to clear the
            current value.
          examples:
            - CONNECT
            - DELETE
            - GET
            - HEAD
            - OPTIONS
            - PATCH
            - POST
            - PUT
            - TRACE
        http_version:
          anyOf:
            - enum:
                - '1.0'
                - '1.1'
              type: string
            - type: 'null'
          description: >-
            HTTP version. Can only be used together with `HTTP` or `HTTPS`
            health monitor type. Supported values: 1.0, 1.1. Omit to leave
            unchanged. Set to `null` to clear the current value.
          examples:
            - '1.1'
            - '1.0'
          title: Http Version
        max_retries:
          description: >-
            Number of successes before the member is switched to ONLINE state.
            Omit to leave unchanged.
          example: 2
          examples:
            - 2
          maximum: 10
          minimum: 1
          title: Max Retries
          type: integer
        max_retries_down:
          description: >-
            Number of failures before the member is switched to ERROR state.
            Omit to leave unchanged.
          example: 2
          examples:
            - 2
          maximum: 10
          minimum: 1
          title: Max Retries Down
          type: integer
        timeout:
          description: >-
            The maximum time to connect. Must be less than the delay value. Omit
            to leave unchanged.
          example: 5
          examples:
            - 5
          maximum: 2147483
          minimum: 0
          title: Timeout
          type: integer
        url_path:
          anyOf:
            - pattern: ^/([^/?#%]+(/[^/?#%]+)*/?)?$
              type: string
            - type: 'null'
          description: >-
            The HTTP path the health monitor requests on each member. Can only
            be used with `HTTP` or `HTTPS` health monitor type.


            Must start with `/` and contain only plain path segments. Query
            strings (`?`), fragments (`#`), percent-encoding (`%`), and
            consecutive slashes (`//`) are not allowed.


            Examples of valid paths:

            - `/` — check the root (most common)

            - `/healthz` — a dedicated health endpoint


            Omit to leave unchanged. Set to `null` to clear the current value.
          examples:
            - /
            - /healthz
          title: Url Path
      title: PatchLbHealthMonitorSerializerV2
      type: object
    TaskIDsSerializer:
      properties:
        tasks:
          description: >-
            List of task IDs representing asynchronous operations. Use these IDs
            to monitor operation progress:
              - `GET /v1/tasks/{task_id}` - Check individual task status and details
              Poll task status until completion (`FINISHED`/`ERROR`) before proceeding with dependent operations.
          example:
            - d478ae29-dedc-4869-82f0-96104425f565
          examples:
            - - d478ae29-dedc-4869-82f0-96104425f565
          items:
            type: string
          title: Tasks
          type: array
      required:
        - tasks
      title: TaskIDsSerializer
      type: object
    HttpMethodEnum:
      enum:
        - CONNECT
        - DELETE
        - GET
        - HEAD
        - OPTIONS
        - PATCH
        - POST
        - PUT
        - TRACE
      title: HttpMethodEnum
      type: string
  securitySchemes:
    APIKey:
      description: >-
        API key for authentication. Make sure to include the word `apikey`,
        followed by a single space and then your token.

        Example: `apikey 1234_abcdef`
      type: apiKey
      in: header
      name: Authorization

````