HubSpot CRM Pipeline Governance API

openapi: 3.0.1
info:
  title: HubSpot CRM Pipeline Governance
  description: Basepom for all HubSpot Projects
  version: 2026-09
  x-hubspot-product-tier-requirements:
    marketing: FREE
    sales: FREE
    service: FREE
    cms: FREE
    commerce: FREE
    crmHub: FREE
    dataHub: FREE
servers:
- url: https://api.hubapi.com
tags:
- name: Advanced
- name: Basic
paths:
  /crm/pipelines-rules/2026-09/{objectTypeId}/{pipelineId}:
    get:
      tags:
      - Basic
      summary: Retrieve rules
      description: Retrieve the rules associated with a specific pipeline in your HubSpot account. This
        endpoint allows you to access governance validation rules and approval stages for the specified
        pipeline. It is useful for understanding the constraints and approval processes applied to the
        pipeline.
      operationId: get-/crm/pipelines-rules/2026-09/{objectTypeId}/{pipelineId}
      parameters:
      - name: objectTypeId
        in: path
        description: The unique identifier of the object type for which the pipeline rules are being retrieved.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: pipelineId
        in: path
        description: The unique identifier of the pipeline whose rules are being retrieved.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicPipelineRules'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm-pipelines-governance-read
    put:
      tags:
      - Basic
      summary: Update rules (Replace)
      description: Update the rules for a specific pipeline in your HubSpot account. This endpoint allows
        you to modify governance validation rules and approval stages associated with a pipeline. It requires
        specifying the object type and pipeline identifiers.
      operationId: put-/crm/pipelines-rules/2026-09/{objectTypeId}/{pipelineId}
      parameters:
      - name: objectTypeId
        in: path
        description: The unique identifier of the object type for which the pipeline rules are being updated.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: pipelineId
        in: path
        description: The unique identifier of the pipeline whose rules are being updated.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PublicPipelineRulesUpdateRequest'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicPipelineRules'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm-pipelines-governance-write
    delete:
      tags:
      - Basic
      summary: Delete
      description: Delete a specific set of pipeline rules associated with a given object type and pipeline
        ID in your HubSpot account. This operation is useful for removing obsolete or incorrect rules
        from a pipeline. Ensure that the objectTypeId and pipelineId are correctly specified to avoid
        unintended deletions.
      operationId: delete-/crm/pipelines-rules/2026-09/{objectTypeId}/{pipelineId}
      parameters:
      - name: objectTypeId
        in: path
        description: The unique identifier of the object type associated with the pipeline rules to delete.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: pipelineId
        in: path
        description: The unique identifier of the pipeline whose rules are to be deleted.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      responses:
        '204':
          description: No content
          content: {}
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm-pipelines-governance-write
    patch:
      tags:
      - Basic
      summary: Update rules (Partial)
      description: Update the rules for a specific pipeline within a given object type in HubSpot. This
        operation allows you to modify governance validation rules and approval stages for the specified
        pipeline. It is useful for maintaining or altering the workflow rules associated with your pipelines.
      operationId: patch-/crm/pipelines-rules/2026-09/{objectTypeId}/{pipelineId}
      parameters:
      - name: objectTypeId
        in: path
        description: The unique identifier of the object type for which the pipeline rules are being updated.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: pipelineId
        in: path
        description: The unique identifier of the pipeline whose rules are being updated.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PublicPipelineRulesPatchRequest'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicPipelineRules'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm-pipelines-governance-write
  /crm/pipelines-rules/2026-09/{objectTypeId}/{pipelineId}/approvals/start:
    post:
      tags:
      - Advanced
      summary: Start Approval
      description: Initiate the approval process for a specific pipeline within a given object type. This
        endpoint is useful for triggering approval workflows that are associated with pipeline stages,
        ensuring that the necessary approvals are obtained before proceeding with further actions in the
        pipeline.
      operationId: post-/crm/pipelines-rules/2026-09/{objectTypeId}/{pipelineId}/approvals/start_/crm/pipelines-rules/2026-09-beta/{objectTypeId}/{pipelineId}/approvals/start
      parameters:
      - name: objectTypeId
        in: path
        description: The unique identifier of the object type for which the approval process is being
          started.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: pipelineId
        in: path
        description: The unique identifier of the pipeline for which the approval process is being initiated.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      requestBody:
        content:
          '*/*':
            schema:
              $ref: '#/components/schemas/PublicCreateApprovalRequest'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicObjectApprovalStatus'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm-pipelines-governance-write
  /crm/pipelines-rules/2026-09/{objectTypeId}/{pipelineId}/approvals/{objectId}:
    get:
      tags:
      - Basic
      summary: Retrieve Approval
      description: Retrieve the approval status of a specific object within a pipeline. This endpoint
        is useful for checking the current approval state of an object, which can be critical in workflows
        that require validation or authorization steps.
      operationId: get-/crm/pipelines-rules/2026-09/{objectTypeId}/{pipelineId}/approvals/{objectId}
      parameters:
      - name: objectId
        in: path
        description: The unique identifier of the object for which the approval status is being retrieved.
        required: true
        style: simple
        explode: false
        schema:
          type: integer
          format: int64
      - name: objectTypeId
        in: path
        description: The unique identifier for the type of object being referenced.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: pipelineId
        in: path
        description: The unique identifier of the pipeline containing the object.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicObjectApprovalStatus'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - deal-approval-read
  /crm/pipelines-rules/2026-09/{objectTypeId}/{pipelineId}/stage-edit-permissions:
    get:
      tags:
      - Basic
      summary: Retrieve permissions
      description: Retrieve the stage edit permissions for a specific pipeline in your HubSpot account.
        This endpoint allows you to view the permissions set for editing stages within a given pipeline,
        identified by its object type and pipeline ID. This can be useful for managing access and ensuring
        that only authorized users can modify pipeline stages.
      operationId: get-/crm/pipelines-rules/2026-09/{objectTypeId}/{pipelineId}/stage-edit-permissions
      parameters:
      - name: objectTypeId
        in: path
        description: The unique identifier of the object type for which the pipeline stage edit permissions
          are being retrieved.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: pipelineId
        in: path
        description: The unique identifier of the pipeline whose stage edit permissions are being retrieved.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicPipelineStagePermissions'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm-pipelines-locked-stages-access
        - pipeline-level-permissions-access
    put:
      tags:
      - Basic
      summary: Update permissions
      description: Update the stage edit permissions for a specific pipeline in your HubSpot account.
        This endpoint allows you to modify which users or teams have access to edit stages within a specified
        pipeline. It is useful for managing access control and ensuring that only authorized personnel
        can make changes to the pipeline stages.
      operationId: put-/crm/pipelines-rules/2026-09/{objectTypeId}/{pipelineId}/stage-edit-permissions
      parameters:
      - name: objectTypeId
        in: path
        description: The unique identifier of the object type associated with the pipeline.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: pipelineId
        in: path
        description: The unique identifier of the pipeline for which stage edit permissions are being
          updated.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PublicPipelineStagePermissionsUpdateRequest'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicPipelineStagePermissions'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm-access
        - crm-pipelines-locked-stages-write
        - pipeline-level-permissions-write
components:
  schemas:
    Error:
      required:
      - category
      - correlationId
      - message
      type: object
      properties:
        category:
          type: string
          description: A string representing the general category of the error.
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: An object containing additional context about the error condition, with properties
            as arrays of strings.
          example: '{invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]}'
        correlationId:
          type: string
          description: A string that uniquely identifies the request for tracking and debugging purposes.
          format: uuid
          example: aeb5f871-7f07-4993-9211-075dc63e7cbf
        errors:
          type: array
          description: An array of ErrorDetail objects that provide detailed information about each error
            encountered.
          items:
            $ref: '#/components/schemas/ErrorDetail'
        links:
          type: object
          additionalProperties:
            type: string
          description: An object containing related links, where each key is a string and the value is
            a string representing a URL.
        message:
          type: string
          description: A string containing a human-readable message describing the error.
          example: An error occurred
        subCategory:
          type: string
          description: A string providing more specific details about the error category.
      description: Represents an error response returned by the API when an operation fails. This component
        is used in various endpoints to provide detailed information about the error encountered.
      example:
        message: Invalid input (details will vary based on the error)
        correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
        category: VALIDATION_ERROR
        links:
          knowledge-base: https://www.hubspot.com/products/service/knowledge-base
    ErrorDetail:
      required:
      - message
      type: object
      properties:
        code:
          type: string
          description: The status code associated with the error detail. This is a string property.
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Context about the error condition, represented as an object with additional properties.
            Each property is an array of strings providing further details.
          example: '{missingScopes=[scope1, scope2]}'
        in:
          type: string
          description: The name of the field or parameter in which the error was found. This is a string
            property.
        message:
          type: string
          description: A human readable message describing the error along with remediation steps where
            appropriate. It is a required string property.
        subCategory:
          type: string
          description: A specific category that contains more specific detail about the error. This is
            a string property.
      description: Represents detailed information about an error that occurred in the API. This component
        is used to provide additional context and specifics about errors, typically as part of an error
        response.
    PublicAbsoluteComparativeTimestampRefineBy:
      title: ABSOLUTE_COMPARATIVE
      required:
      - comparison
      - timestamp
      - type
      type: object
      properties:
        comparison:
          type: string
          description: A string representing the type of comparison to be made with the timestamp.
        timestamp:
          type: integer
          description: An integer representing the specific point in time to be used for the comparison,
            formatted as a Unix timestamp in milliseconds.
          format: int64
        type:
          type: string
          description: A string indicating the type of refinement, which is 'ABSOLUTE_COMPARATIVE'.
          default: ABSOLUTE_COMPARATIVE
          enum:
          - ABSOLUTE_COMPARATIVE
      x-hubspot-sub-type-impl: true
    PublicAbsoluteRangedTimestampRefineBy:
      title: ABSOLUTE_RANGED
      required:
      - lowerTimestamp
      - rangeType
      - type
      - upperTimestamp
      type: object
      properties:
        lowerTimestamp:
          type: integer
          description: An integer representing the lower bound of the timestamp range, specified as a
            Unix timestamp in milliseconds.
          format: int64
        rangeType:
          type: string
          description: A string representing the type of range being defined.
        type:
          type: string
          description: A string that specifies the type of refine by operation. The default value is 'ABSOLUTE_RANGED'.
          default: ABSOLUTE_RANGED
          enum:
          - ABSOLUTE_RANGED
        upperTimestamp:
          type: integer
          description: An integer representing the upper bound of the timestamp range, specified as a
            Unix timestamp in milliseconds.
          format: int64
      x-hubspot-sub-type-impl: true
    PublicAdsSearchFilter:
      title: ADS_SEARCH
      required:
      - adNetwork
      - entityType
      - filterType
      - operator
      - searchTermType
      - searchTerms
      type: object
      properties:
        adNetwork:
          type: string
          description: A string identifying the ad network where the search is performed.
        entityType:
          type: string
          description: A string representing the type of entity being filtered.
        filterType:
          type: string
          description: A string indicating the type of filter being applied. Default value is 'ADS_SEARCH'.
          default: ADS_SEARCH
          enum:
          - ADS_SEARCH
        operator:
          type: string
          description: A string that specifies the operation or condition applied to the filter.
        searchTermType:
          type: string
          description: A string specifying the type of search term used in the filter.
        searchTerms:
          type: array
          description: An array of strings containing the terms used to search within the ad network.
          items:
            type: string
      x-hubspot-sub-type-impl: true
    PublicAdsTimeFilter:
      title: ADS_TIME
      required:
      - filterType
      - pruningRefineBy
      type: object
      properties:
        filterType:
          type: string
          description: A string that indicates the type of filter being applied. The default value is
            'ADS_TIME'.
          default: ADS_TIME
          enum:
          - ADS_TIME
        pruningRefineBy:
          description: An object that defines the criteria for refining the filter based on time attributes.
            It can be one of several types, such as PublicNumOccurrencesRefineBy, PublicSetOccurrencesRefineBy,
            or various timestamp refine types.
          oneOf:
          - $ref: '#/components/schemas/PublicNumOccurrencesRefineBy'
          - $ref: '#/components/schemas/PublicSetOccurrencesRefineBy'
          - $ref: '#/components/schemas/PublicRelativeComparativeTimestampRefineBy'
          - $ref: '#/components/schemas/PublicRelativeRangedTimestampRefineBy'
          - $ref: '#/components/schemas/PublicAbsoluteComparativeTimestampRefineBy'
          - $ref: '#/components/schemas/PublicAbsoluteRangedTimestampRefineBy'
          - $ref: '#/components/schemas/PublicAllHistoryRefineBy'
          - $ref: '#/components/schemas/PublicTimePointOperation'
          - $ref: '#/components/schemas/PublicRangedTimeOperation'
      x-hubspot-sub-type-impl: true
    PublicAllHistoryRefineBy:
      title: ALL_HISTORY
      required:
      - type
      type: object
      properties:
        type:
          type: string
          description: A string representing the type of refinement. The default and only valid value
            is 'ALL_HISTORY'.
          default: ALL_HISTORY
          enum:
          - ALL_HISTORY
      x-hubspot-sub-type-impl: true
    PublicAllPropertyTypesOperation:
      title: ALL_PROPERTY
      required:
      - includeObjectsWithNoValueSet
      - operationType
      - operator
      type: object
      properties:
        includeObjectsWithNoValueSet:
          type: boolean
          description: A boolean indicating whether to include objects that have no value set for the
            property.
        operationType:
          type: string
          description: A string indicating the type of operation. The default and only valid value is
            'ALL_PROPERTY_TYPES'.
          default: ALL_PROPERTY
          enum:
          - ALL_PROPERTY
        operator:
          type: string
          description: A string representing the operator to be used in the operation.
      x-hubspot-sub-type-impl: true
    PublicAndFilterBranch:
      title: AND
      required:
      - filterBranchOperator
      - filterBranchType
      - filterBranches
      - filters
      type: object
      properties:
        filterBranchOperator:
          type: string
          description: A string representing the logical operator used in the filter branch.
        filterBranchType:
          type: string
          description: A string indicating the type of filter branch. Defaults to 'AND'.
          default: AND
          enum:
          - AND
        filterBranches:
          type: array
          description: An array of nested filter branches, which can include 'OR', 'AND', 'NOT_ALL', 'NOT_ANY',
            'RESTRICTED', 'UNIFIED_EVENTS', and 'ASSOCIATION' filter branches.
          items:
            oneOf:
            - $ref: '#/components/schemas/PublicOrFilterBranch'
            - $ref: '#/components/schemas/PublicAndFilterBranch'
            - $ref: '#/components/schemas/PublicNotAllFilterBranch'
            - $ref: '#/components/schemas/PublicNotAnyFilterBranch'
            - $ref: '#/components/schemas/PublicRestrictedFilterBranch'
            - $ref: '#/components/schemas/PublicUnifiedEventsFilterBranch'
            - $ref: '#/components/schemas/PublicAssociationFilterBranch'
        filters:
          type: array
          description: An array of filters that are applied within this branch. These can include various
            types of filters such as property filters, event filters, and subscription filters.
          items:
            oneOf:
            - $ref: '#/components/schemas/PublicPropertyFilter'
            - $ref: '#/components/schemas/PublicAssociationInListFilter'
            - $ref: '#/components/schemas/PublicPageViewAnalyticsFilter'
            - $ref: '#/components/schemas/PublicCtaAnalyticsFilter'
            - $ref: '#/components/schemas/PublicEventAnalyticsFilter'
            - $ref: '#/components/schemas/PublicFormSubmissionFilter'
            - $ref: '#/components/schemas/PublicFormSubmissionOnPageFilter'
            - $ref: '#/components/schemas/PublicIntegrationEventFilter'
            - $ref: '#/components/schemas/PublicEmailSubscriptionFilter'
            - $ref: '#/components/schemas/PublicCommunicationSubscriptionFilter'
            - $ref: '#/components/schemas/PublicSurveyMonkeyFilter'
            - $ref: '#/components/schemas/PublicSurveyMonkeyValueFilter'
            - $ref: '#/components/schemas/PublicWebinarFilter'
            - $ref: '#/components/schemas/PublicEmailEventFilter'
            - $ref: '#/components/schemas/PublicPrivacyAnalyticsFilter'
            - $ref: '#/components/schemas/PublicAdsSearchFilter'
            - $ref: '#/components/schemas/PublicAdsTimeFilter'
            - $ref: '#/components/schemas/PublicInListFilter'
            - $ref: '#/components/schemas/PublicUnifiedEventsFilter'
            - $ref: '#/components/schemas/PublicConstantFilter'
      x-hubspot-sub-type-impl: true
    PublicApprovalStageRule:
      required:
      - approvalMode
      - approverUserIds
      - pipelineStageId
      type: object
      properties:
        approvalComment:
          type: string
          description: A string that allows for an optional comment or note regarding the approval process.
        approvalMode:
          type: string
          description: Specifies the mode of approval required. It can be either 'ALL', meaning all approvers
            must approve, or 'ANY', meaning any one approver can approve. It is a string.
          enum:
          - ALL
          - ANY
        approverUserIds:
          type: array
          description: An array of user IDs representing the users who are designated as approvers for
            this stage. Each user ID is a string.
          items:
            type: string
        conditionalApprovalFilterBranch:
          description: Defines the conditions under which the approval is required. It can be one of several
            filter branch types, such as PublicOrFilterBranch or PublicAndFilterBranch, which determine
            the logical conditions for approval.
          oneOf:
          - $ref: '#/components/schemas/PublicOrFilterBranch'
          - $ref: '#/components/schemas/PublicAndFilterBranch'
          - $ref: '#/components/schemas/PublicNotAllFilterBranch'
          - $ref: '#/components/schemas/PublicNotAnyFilterBranch'
          - $ref: '#/components/schemas/PublicRestrictedFilterBranch'
          - $ref: '#/components/schemas/PublicUnifiedEventsFilterBranch'
          - $ref: '#/components/schemas/PublicAssociationFilterBranch'
        pipelineStageId:
          type: string
          description: The unique identifier for the pipeline stage that this approval rule applies to.
            It is a string.
    PublicApprovalStageRuleRequest:
      required:
      - approvalMode
      - approverUserIds
      - pipelineStageId
      type: object
      properties:
        approvalComment:
          type: string
          description: A string that allows an optional comment to be added to the approval rule.
        approvalMode:
          type: string
          description: Specifies the mode of approval required. It can be either 'ALL', meaning all specified
            users must approve, or 'ANY', meaning any one of the specified users can approve.
          enum:
          - ALL
          - ANY
        approverUserIds:
          type: array
          description: An array of user IDs representing the users who are authorized to approve the stage
            transition. Each ID is a string.
          items:
            type: string
        conditionalApprovalFilterBranch:
          description: Defines conditional logic for the approval process using a filter branch. It can
            be one of several types, such as PublicOrFilterBranch or PublicAndFilterBranch, to specify
            complex approval conditions.
          oneOf:
          - $ref: '#/components/schemas/PublicOrFilterBranch'
          - $ref: '#/components/schemas/PublicAndFilterBranch'
          - $ref: '#/components/schemas/PublicNotAllFilterBranch'
          - $ref: '#/components/schemas/PublicNotAnyFilterBranch'
          - $ref: '#/components/schemas/PublicRestrictedFilterBranch'
          - $ref: '#/components/schemas/PublicUnifiedEventsFilterBranch'
          - $ref: '#/components/schemas/PublicAssociationFilterBranch'
        pipelineStageId:
          type: string
          description: The unique identifier for the pipeline stage that the approval rule applies to.
            It is a string.
    PublicAssociationFilterBranch:
      title: ASSOCIATION
      required:
      - associationCategory
      - associationTypeId
      - filterBranchOperator
      - filterBranchType
      - filterBranches
      - filters
      - objectTypeId
      - operator
      type: object
      properties:
        associationCategory:
          type: string
          description: A string indicating the category of the association.
        associationTypeId:
          type: integer
          description: An integer representing the ID of the association type.
          format: int32
        filterBranchOperator:
          type: string
          description: A string representing the operator used to combine the filter branches.
        filterBranchType:
          type: string
          description: A string indicating the type of filter branch, which is 'ASSOCIATION' by default.
          default: ASSOCIATION
          enum:
          - ASSOCIATION
        filterBranches:
          type: array
          description: An array of filter branches that can include various types of branches such as
            OR, AND, NOT_ALL, NOT_ANY, RESTRICTED, UNIFIED_EVENTS, and ASSOCIATION.
          items:
            oneOf:
            - $ref: '#/components/schemas/PublicOrFilterBranch'
            - $ref: '#/components/schemas/PublicAndFilterBranch'
            - $ref: '#/components/schemas/PublicNotAllFilterBranch'
            - $ref: '#/components/schemas/PublicNotAnyFilterBranch'
            - $ref: '#/components/schemas/PublicRestrictedFilterBranch'
            - $ref: '#/components/schemas/PublicUnifiedEventsFilterBranch'
            - $ref: '#/components/schemas/PublicAssociationFilterBranch'
        filters:
          type: array
          description: An array of filters that can include different types of filters such as property
            filters, association filters, and various analytics filters.
          items:
            oneOf:
            - $ref: '#/components/schemas/PublicPropertyFilter'
            - $ref: '#/components/schemas/PublicAssociationInListFilter'
            - $ref: '#/components/schemas/PublicPageViewAnalyticsFilter'
            - $ref: '#/components/schemas/PublicCtaAnalyticsFilter'
            - $ref: '#/components/schemas/PublicEventAnalyticsFilter'
            - $ref: '#/components/schemas/PublicFormSubmissionFilter'
            - $ref: '#/components/schemas/PublicFormSubmissionOnPageFilter'
            - $ref: '#/components/schemas/PublicIntegrationEventFilter'
            - $ref: '#/components/schemas/PublicEmailSubscriptionFilter'
            - $ref: '#/components/schemas/PublicCommunicationSubscriptionFilter'
            - $ref: '#/components/schemas/PublicSurveyMonkeyFilter'
            - $ref: '#/components/schemas/PublicSurveyMonkeyValueFilter'
            - $ref: '#/components/schemas/PublicWebinarFilter'
            - $ref: '#/components/schemas/PublicEmailEventFilter'
            - $ref: '#/components/schemas/PublicPrivacyAnalyticsFilter'
            - $ref: '#/components/schemas/PublicAdsSearchFilter'
            - $ref: '#/components/schemas/PublicAdsTimeFilter'
            - $ref: '#/components/schemas/PublicInListFilter'
            - $ref: '#/components/schemas/PublicUnifiedEventsFilter'
            - $ref: '#/components/schemas/PublicConstantFilter'
        objectTypeId:
          type: string
          description: A string representing the ID of the object type involved in the association.
        operator:
          type: string
          description: A string representing the operator used in the filter branch.
      x-hubspot-sub-type-impl: true
    PublicAssociationInListFilter:
      title: ASSOCIATION
      required:
      - associationCategory
      - associationTypeId
      - coalescingRefineBy
      - filterType
      - listId
      - operator
      type: object
      properties:
        associationCategory:
          type: string
          description: A string that specifies the category of the association.
        associationTypeId:
          type: integer
          description: An integer that identifies the type of association.
          format: int32
      

# --- truncated at 32 KB (132 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/openapi/hubspot-crm-pipeline-governance-api-openapi.yml