openapi: 3.2.0
info:
  title: Blub0x Engage API
  version: '2026-09-29'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-09-29: 13 operation(s) read from 1 public documentation page(s) (each operation names its page in x-source). This is not the provider''s published contract; Blub0x has published no machine-readable contract that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 0
    documentation: 13
    pages-with-code: 0
    pages-read: 1
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-09-29'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://bluinfo.z13.web.core.windows.net/BluB0X_Officially_Supports_Allegion_NDE__LE__BE_and_FE_Locks_with_the_Gateways
tags:
- name: Engage
paths:
  /engage/devices/{devicereference}/site/{sitereference}:
    delete:
      operationId: delete_engage_devices_devicereference_site_sitereference
      tags:
      - Engage
      summary: Pass Delete Device from a given site
      x-source: https://bluinfo.z13.web.core.windows.net/BluB0X_Officially_Supports_Allegion_NDE__LE__BE_and_FE_Locks_with_the_Gateways
      parameters:
      - name: devicereference
        in: path
        required: true
        schema:
          type: string
      - name: sitereference
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    put:
      operationId: put_engage_devices_devicereference_site_sitereference
      tags:
      - Engage
      summary: Update Name for the device
      x-source: https://bluinfo.z13.web.core.windows.net/BluB0X_Officially_Supports_Allegion_NDE__LE__BE_and_FE_Locks_with_the_Gateways
      parameters:
      - name: devicereference
        in: path
        required: true
        schema:
          type: string
      - name: sitereference
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /engage/devices/{hexserialnumber}/SiteReference:
    get:
      operationId: get_engage_devices_hexserialnumber_SiteReference
      tags:
      - Engage
      summary: Get Site Reference identifier using hex serial number for a device that has…
      x-source: https://bluinfo.z13.web.core.windows.net/BluB0X_Officially_Supports_Allegion_NDE__LE__BE_and_FE_Locks_with_the_Gateways
      parameters:
      - name: hexserialnumber
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /engage/fimware/{devicetype}:
    get:
      operationId: get_engage_fimware_devicetype
      tags:
      - Engage
      summary: Get Firmware List
      x-source: https://bluinfo.z13.web.core.windows.net/BluB0X_Officially_Supports_Allegion_NDE__LE__BE_and_FE_Locks_with_the_Gateways
      parameters:
      - name: devicetype
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /engage/sites:
    get:
      operationId: get_engage_sites
      tags:
      - Engage
      summary: Pass List Sites
      x-source: https://bluinfo.z13.web.core.windows.net/BluB0X_Officially_Supports_Allegion_NDE__LE__BE_and_FE_Locks_with_the_Gateways
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /engage/sites/operators/{operatorid}:
    delete:
      operationId: delete_engage_sites_operators_operatorid
      tags:
      - Engage
      summary: Pass Delete Operators Recommended
      x-source: https://bluinfo.z13.web.core.windows.net/BluB0X_Officially_Supports_Allegion_NDE__LE__BE_and_FE_Locks_with_the_Gateways
      parameters:
      - name: operatorid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /engage/sites/{siteid}:
    post:
      operationId: post_engage_sites_siteid
      tags:
      - Engage
      summary: Pass Invite Operators(Users) - SiteAdmin/Manager/Operator Required
      x-source: https://bluinfo.z13.web.core.windows.net/BluB0X_Officially_Supports_Allegion_NDE__LE__BE_and_FE_Locks_with_the_Gateways
      parameters:
      - name: siteid
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
        collapsed_from: 2 example path(s) differing only at siteId
  /engage/sites/{sitereference}:
    delete:
      operationId: delete_engage_sites_sitereference
      tags:
      - Engage
      summary: Pass Delete Site
      x-source: https://bluinfo.z13.web.core.windows.net/BluB0X_Officially_Supports_Allegion_NDE__LE__BE_and_FE_Locks_with_the_Gateways
      parameters:
      - name: sitereference
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    put:
      operationId: put_engage_sites_sitereference
      tags:
      - Engage
      summary: Pass Update Site Name
      x-source: https://bluinfo.z13.web.core.windows.net/BluB0X_Officially_Supports_Allegion_NDE__LE__BE_and_FE_Locks_with_the_Gateways
      parameters:
      - name: sitereference
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /engage/sites/{sitereference}/devicedefaults:
    put:
      operationId: put_engage_sites_sitereference_devicedefaults
      tags:
      - Engage
      summary: Pass Device Settings
      x-source: https://bluinfo.z13.web.core.windows.net/BluB0X_Officially_Supports_Allegion_NDE__LE__BE_and_FE_Locks_with_the_Gateways
      parameters:
      - name: sitereference
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /engage/sites/{sitereference}/devicedefaults/{devicetype}:
    post:
      operationId: post_engage_sites_sitereference_devicedefaults_devicetype
      tags:
      - Engage
      summary: Pass Device Settings
      x-source: https://bluinfo.z13.web.core.windows.net/BluB0X_Officially_Supports_Allegion_NDE__LE__BE_and_FE_Locks_with_the_Gateways
      parameters:
      - name: sitereference
        in: path
        required: true
        schema:
          type: string
      - name: devicetype
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /engage/sites/{sitereference}/{id}:
    get:
      operationId: get_engage_sites_sitereference_id
      tags:
      - Engage
      summary: Pass Device Settings
      x-source: https://bluinfo.z13.web.core.windows.net/BluB0X_Officially_Supports_Allegion_NDE__LE__BE_and_FE_Locks_with_the_Gateways
      parameters:
      - name: sitereference
        in: path
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
        collapsed_from: 2 example path(s) differing only at id