> ## Documentation index
> Fetch the complete documentation index at: https://developer.rhombus.com/llms.txt
> Use it to discover all available pages before exploring further.

# Get recent policy alerts for a location, grouped by time

> Get recent policy alerts for a location, grouped by time. Groups are constructed of alerts that occur within 2 minutes of the previous alert, up to a maximum of 50. Results are returned in reverse-chronological order, so all fields are relative to that ordering.

```http
POST https://api2.rhombussystems.com/api/event/getPolicyAlertGroupsForLocation
```

EU organizations send the same request to `https://api2.eu.rhombussystems.com`.

## Authentication and parameters

- `x-auth-apikey` (header, required): Your Rhombus API key. Must be accompanied by the `x-auth-scheme` header set to `api-token` (or `partner-api-token` for partner endpoints).
- `Authorization` (header): instead of an API key, an OAuth access token (`Bearer <token>`) with the `read` scope.
- `x-auth-scheme` (header, string, default: `api-token`): Authentication scheme identifier. Use `api-token` or `partner-api-token` with the `x-auth-apikey` header, `api` or `partner-api` with `x-auth-apikey` plus a client certificate, `api-oauth-token` or `partner-api-oauth-token` with `x-auth-access-token`, and `federated-token` with `x-auth-ft`. A request with `Authorization: Bearer <token>` and no `x-auth-scheme` is treated as OAuth, and `federated-token` may also be sent as the `x-auth-scheme` and `x-auth-ft` query parameters. One of: `api-token`, `api`, `api-oauth-token`, `federated-token`, `partner-api-token`, `partner-api`, `partner-api-oauth-token`.
- `x-auth-org` (header, string<RUUID>): Client organization UUID (22-character RUUID), for partner credentials only. With it the call runs in that client organization with the partner support authority's role. Without it a partner credential runs as the partner organization, which outside the partner endpoints is deprecated (responses carry `Deprecation` and `Sunset: Tue, 05 Jan 2027 00:00:00 GMT`). A malformed value returns 400 `INVALID_AUTH_ORG`; a client organization the partner cannot access returns 403 `PARTNER_CLIENT_ACCESS_DENIED`.

## Request body

Content type: `application/json`. Request object for retrieving policy alert groups for a specific location.

- `lastTimestampMs` (integer<int64> | null): Last timestamp for pagination
- `lastUuid` (string<RUUID> | null): base 64 (url-safe) uuid string
- `locationUuid` (string<RUUID> | null): base 64 (url-safe) uuid string
- `maxResults` (integer<int32> | null): Maximum number of results to return

## Response 200

OK. Content type: `application/json`

- `error` (boolean | null)
- `errorCode` (string | null): Stable, machine-readable code for the failure (one of the ApiErrorCode catalog) when error is true. Branch on this, not on errorMsg.
- `errorMsg` (string | null)
- `policyAlertGroups` (array<object> | null): List of policy alert groups for the location
- `warningMsg` (string | null)

## Errors

Also 400, 401, 403, 429, 500, 503 with the standard error body (`errorCode`, `errorMsg`): https://developer.rhombus.com/errors

## OpenAPI

````yaml
openapi: 3.0.1
info:
  title: Rhombus API
  version: "1.0"
servers:
  - description: Production Server
    url: https://api2.rhombussystems.com
security:
  - ApiKeyAuth: []
paths:
  /api/event/getPolicyAlertGroupsForLocation:
    post:
      description: Get recent policy alerts for a location, grouped by time. Groups are constructed of alerts that occur within 2 minutes of the previous alert, up to a maximum of 50. Results are returned in reverse-chronological order, so all fields are relative to that ordering.
      operationId: getPolicyAlertGroupsForLocation
      parameters:
        - description: "Authentication scheme identifier. Use `api-token` or `partner-api-token` with the `x-auth-apikey` header, `api` or `partner-api` with `x-auth-apikey` plus a client certificate, `api-oauth-token` or `partner-api-oauth-token` with `x-auth-access-token`, and `federated-token` with `x-auth-ft`. A request with `Authorization: Bearer <token>` and no `x-auth-scheme` is treated as OAuth, and `federated-token` may also be sent as the `x-auth-scheme` and `x-auth-ft` query parameters."
          example: api-token
          in: header
          name: x-auth-scheme
          required: false
          schema:
            default: api-token
            enum:
              - api-token
              - api
              - api-oauth-token
              - federated-token
              - partner-api-token
              - partner-api
              - partner-api-oauth-token
            type: string
        - description: "Client organization UUID (22-character RUUID), for partner credentials only. With it the call runs in that client organization with the partner support authority's role. Without it a partner credential runs as the partner organization, which outside the partner endpoints is deprecated (responses carry `Deprecation` and `Sunset: Tue, 05 Jan 2027 00:00:00 GMT`). A malformed value returns 400 `INVALID_AUTH_ORG`; a client organization the partner cannot access returns 403 `PARTNER_CLIENT_ACCESS_DENIED`."
          in: header
          name: x-auth-org
          required: false
          schema:
            format: RUUID
            maxLength: 22
            minLength: 22
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/Event_GetPolicyAlertGroupsForLocationWSRequest"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Event_GetPolicyAlertGroupsForLocationWSResponse"
          description: OK
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "403":
          $ref: "#/components/responses/Forbidden"
        "429":
          $ref: "#/components/responses/TooManyRequests"
        "500":
          $ref: "#/components/responses/InternalServerError"
        "503":
          $ref: "#/components/responses/ServiceUnavailable"
      security:
        - ApiKeyAuth: []
        - oauth2:
            - read
      summary: Get recent policy alerts for a location, grouped by time
      tags:
        - Event Webservice
components:
  schemas:
    Event_GetPolicyAlertGroupsForLocationWSRequest:
      description: Request object for retrieving policy alert groups for a specific location.
      properties:
        lastTimestampMs:
          description: Last timestamp for pagination
          example: 1640995200000
          format: int64
          nullable: true
          type: integer
        lastUuid:
          description: base 64 (url-safe) uuid string
          example: AAAAAAAAAAAAAAAAAAAAAA
          format: RUUID
          nullable: true
          type: string
        locationUuid:
          description: base 64 (url-safe) uuid string
          example: AAAAAAAAAAAAAAAAAAAAAA
          format: RUUID
          nullable: true
          type: string
        maxResults:
          description: Maximum number of results to return
          example: 100
          format: int32
          nullable: true
          type: integer
      type: object
    Event_GetPolicyAlertGroupsForLocationWSResponse:
      description: Response object containing policy alert groups for a specific location.
      properties:
        error:
          nullable: true
          type: boolean
        errorCode:
          description: Stable, machine-readable code for the failure (one of the ApiErrorCode catalog) when error is true. Branch on this, not on errorMsg.
          nullable: true
          type: string
        errorMsg:
          nullable: true
          type: string
        policyAlertGroups:
          description: List of policy alert groups for the location
          items:
            $ref: "#/components/schemas/Event_PolicyAlertGroupV2"
          nullable: true
          type: array
        warningMsg:
          nullable: true
          type: string
      type: object
    Event_PolicyAlertGroupV2:
      description: Group of policy alerts V2 with time range information.
      properties:
        endTime:
          description: End time of the alert group (descending chronological order)
          example: 1641081600000
          format: int64
          nullable: true
          type: integer
        policyAlerts:
          description: List of policy alerts V2 in the group
          items:
            $ref: "#/components/schemas/PolicyAlertV2Type"
          nullable: true
          type: array
        startTime:
          description: Start time of the alert group (descending chronological order)
          example: 1640995200000
          format: int64
          nullable: true
          type: integer
      type: object
    PolicyAlertV2Type:
      allOf:
        - properties:
            airQualityIndex:
              format: int32
              nullable: true
              type: integer
            airQualityIndexThreshold:
              format: int32
              nullable: true
              type: integer
            alertingDwellEvents:
              items:
                $ref: "#/components/schemas/DwellEventType"
              nullable: true
              type: array
            alertingEventFaces:
              items:
                $ref: "#/components/schemas/PolicyEventFaceType"
              nullable: true
              type: array
            alertingEventVehicles:
              items:
                $ref: "#/components/schemas/PolicyEventVehicleType"
              nullable: true
              type: array
            alertingTrackIds:
              items:
                format: int32
                nullable: true
                type: integer
              nullable: true
              type: array
            cd:
              description: Custom activity display description, maximum 100 characters
              nullable: true
              type: string
            cdn:
              description: Custom activity display name, maximum 32 characters
              nullable: true
              type: string
            ch2oPpb:
              format: float
              nullable: true
              type: number
            ch2oPpbThreshold:
              format: float
              nullable: true
              type: number
            clipLocation:
              $ref: "#/components/schemas/MetaDataLocationType"
            cllmBooleanValue:
              nullable: true
              type: boolean
            cllmCheckCondition:
              $ref: "#/components/schemas/CheckCondition"
            cllmIntegerValue:
              format: int32
              nullable: true
              type: integer
            cllmPromptTypeEnum:
              $ref: "#/components/schemas/PromptTypeEnum"
            cllmPromptUuid:
              description: base 64 (url-safe) uuid string
              example: AAAAAAAAAAAAAAAAAAAAAA
              format: RUUID
              nullable: true
              type: string
            co2:
              format: float
              nullable: true
              type: number
            co2Ppm:
              format: int32
              nullable: true
              type: integer
            co2PpmThreshold:
              format: int32
              nullable: true
              type: integer
            co2Threshold:
              format: float
              nullable: true
              type: number
            coConcentration:
              format: double
              nullable: true
              type: number
            coConcentrationThreshold:
              format: double
              nullable: true
              type: number
            componentUuid:
              description: base 64 (url-safe) uuid string
              example: AAAAAAAAAAAAAAAAAAAAAA
              format: RUUID
              nullable: true
              type: string
            deviceFacetUuid:
              description: RUUID with optional appended facet information
              example: AAAAAAAAAAAAAAAAAAAAAA.v0
              format: DeviceFacetUuid
              nullable: true
              type: string
            deviceType:
              $ref: "#/components/schemas/DeviceTypeEnum"
            deviceUuid:
              description: base 64 (url-safe) uuid string
              example: AAAAAAAAAAAAAAAAAAAAAA
              format: RUUID
              nullable: true
              type: string
            egressBoundaryDevices:
              items:
                description: base 64 (url-safe) uuid string
                example: AAAAAAAAAAAAAAAAAAAAAA
                format: RUUID
                nullable: true
                type: string
              nullable: true
              type: array
            ethanol:
              format: float
              nullable: true
              type: number
            ethanolThreshold:
              format: float
              nullable: true
              type: number
            heatIndexDegF:
              format: double
              nullable: true
              type: number
            heatIndexDegFThreshold:
              format: double
              nullable: true
              type: number
            humidityPercent1616:
              format: int32
              nullable: true
              type: integer
            humidityPercentThreshold1616:
              format: int32
              nullable: true
              type: integer
            humidityPermyriad:
              format: int32
              nullable: true
              type: integer
            humidityThresholdPermyriad:
              format: int32
              nullable: true
              type: integer
            iaq:
              format: float
              nullable: true
              type: number
            iaqThreshold:
              format: float
              nullable: true
              type: number
            inactivityThresholdMs:
              description: For INACTIVITY_* alerts, the inactivity threshold configured on the region that fired, in milliseconds. This is the configured threshold, not the elapsed length of the inactivity window.
              format: int64
              nullable: true
              type: integer
            ingressBoundaryDevices:
              items:
                description: base 64 (url-safe) uuid string
                example: AAAAAAAAAAAAAAAAAAAAAA
                format: RUUID
                nullable: true
                type: string
              nullable: true
              type: array
            leakDetected:
              nullable: true
              type: boolean
            maxLuf:
              format: int32
              nullable: true
              type: integer
            noxIdx:
              format: float
              nullable: true
              type: number
            noxIdxThreshold:
              format: float
              nullable: true
              type: number
            numHumans:
              format: int32
              nullable: true
              type: integer
            peopleCountHighThreshold:
              format: int32
              nullable: true
              type: integer
            peopleCountLowThreshold:
              format: int32
              nullable: true
              type: integer
            pm10p0:
              format: float
              nullable: true
              type: number
            pm10p0Threshold:
              format: float
              nullable: true
              type: number
            pm1p0:
              format: float
              nullable: true
              type: number
            pm1p0Threshold:
              format: float
              nullable: true
              type: number
            pm25:
              format: float
              nullable: true
              type: number
            pm25Threshold:
              format: float
              nullable: true
              type: number
            pm4p0:
              format: float
              nullable: true
              type: number
            pm4p0Threshold:
              format: float
              nullable: true
              type: number
            pressure:
              format: float
              nullable: true
              type: number
            pressureThreshold:
              format: float
              nullable: true
              type: number
            probeTempC:
              format: float
              nullable: true
              type: number
            probeTempCThreshold:
              format: float
              nullable: true
              type: number
            probeTempThreshold:
              format: float
              nullable: true
              type: number
            relHumid:
              format: float
              nullable: true
              type: number
            relHumidThreshold:
              format: float
              nullable: true
              type: number
            tamperByMovementChange:
              format: float
              nullable: true
              type: number
            tampered:
              nullable: true
              type: boolean
            tempC:
              format: float
              nullable: true
              type: number
            tempCThreshold:
              format: float
              nullable: true
              type: number
            tempProbePresent:
              nullable: true
              type: boolean
            temperatureCelsius1616:
              format: int32
              nullable: true
              type: integer
            temperatureCelsiusThreshold1616:
              format: int32
              nullable: true
              type: integer
            temperaturePermyriad:
              format: int32
              nullable: true
              type: integer
            temperatureThresholdPermyriad:
              format: int32
              nullable: true
              type: integer
            thcPercent:
              format: float
              nullable: true
              type: number
            thcPercentThreshold:
              format: float
              nullable: true
              type: number
            tvoc:
              format: float
              nullable: true
              type: number
            tvocThreshold:
              format: float
              nullable: true
              type: number
            vapeDetected:
              nullable: true
              type: boolean
            vapeSmokePercent:
              format: float
              nullable: true
              type: number
            vapeSmokePercentThreshold:
              format: float
              nullable: true
              type: number
            vocIdx:
              format: float
              nullable: true
              type: number
            vocIdxThreshold:
              format: float
              nullable: true
              type: number
          type: object
      nullable: true
      properties:
        alertMonitoringThreatCaseUuid:
          description: base 64 (url-safe) uuid string
          example: AAAAAAAAAAAAAAAAAAAAAA
          format: RUUID
          nullable: true
          type: string
        alertMonitoringVerified:
          nullable: true
          type: boolean
        archived:
          nullable: true
          type: boolean
        clientType:
          $ref: "#/components/schemas/ApiClientTypeEnum"
        clipLocationMap:
          additionalProperties:
            $ref: "#/components/schemas/MetaDataLocationType"
          nullable: true
          type: object
        clipLocationMapV2:
          additionalProperties:
            nullable: true
            type: string
          nullable: true
          type: object
        delayedProcessing:
          nullable: true
          type: boolean
        deleted:
          nullable: true
          type: boolean
        durationSec:
          format: int32
          nullable: true
          type: integer
        finalized:
          nullable: true
          type: boolean
        locationUuid:
          description: base 64 (url-safe) uuid string
          example: AAAAAAAAAAAAAAAAAAAAAA
          format: RUUID
          nullable: true
          type: string
        notificationSent:
          nullable: true
          type: boolean
        orgUuid:
          description: base 64 (url-safe) uuid string
          example: AAAAAAAAAAAAAAAAAAAAAA
          format: RUUID
          nullable: true
          type: string
        policyAlertTriggers:
          items:
            $ref: "#/components/schemas/ActivityEnum"
          nullable: true
          type: array
        policyUuid:
          description: base 64 (url-safe) uuid string
          example: AAAAAAAAAAAAAAAAAAAAAA
          format: RUUID
          nullable: true
          type: string
        ruleUuid:
          description: base 64 (url-safe) uuid string
          example: AAAAAAAAAAAAAAAAAAAAAA
          format: RUUID
          nullable: true
          type: string
        saved:
          nullable: true
          type: boolean
        serverReceivedAtMs:
          format: int64
          nullable: true
          type: integer
        shared:
          nullable: true
          type: boolean
        subLocationsHierarchyKey:
          description: |
            A sequence of one or more base 64 (url-safe) uuid substrings.
            These substrings are separated by dots (.).
          example: AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA
          format: SubLocationsHierarchyKey
          nullable: true
          pattern: ^([A-Za-z0-9\-_]{22})([.][A-Za-z0-9\-_]{22})*$
          type: string
        textDescription:
          description: Natural language description of the alert
          nullable: true
          type: string
        thumbnailLocation:
          $ref: "#/components/schemas/MetaDataLocationType"
        thumbnailLocationV2:
          nullable: true
          type: string
        timestampMs:
          format: int64
          nullable: true
          type: integer
        type:
          $ref: "#/components/schemas/PolicyAlertEnumType"
        uuid:
          description: base 64 (url-safe) uuid string
          example: AAAAAAAAAAAAAAAAAAAAAA
          format: RUUID
          nullable: true
          type: string
      type: object
    DwellEventType:
      nullable: true
      properties:
        activity:
          $ref: "#/components/schemas/ActivityEnum"
        deviceLabels:
          items:
            nullable: true
            type: string
          nullable: true
          type: array
        deviceUuid:
          description: base 64 (url-safe) uuid string
          example: AAAAAAAAAAAAAAAAAAAAAA
          format: RUUID
          nullable: true
          type: string
        durationSec:
          format: int32
          nullable: true
          type: integer
        dwellStartTimeMs:
          format: int64
          nullable: true
          type: integer
        locationLabels:
          items:
            nullable: true
            type: string
          nullable: true
          type: array
        locationUuid:
          description: base 64 (url-safe) uuid string
          example: AAAAAAAAAAAAAAAAAAAAAA
          format: RUUID
          nullable: true
          type: string
        orgUuid:
          description: base 64 (url-safe) uuid string
          example: AAAAAAAAAAAAAAAAAAAAAA
          format: RUUID
          nullable: true
          type: string
        regionUuid:
          description: base 64 (url-safe) uuid string
          example: AAAAAAAAAAAAAAAAAAAAAA
          format: RUUID
          nullable: true
          type: string
        subLocationsHierarchyKey:
          description: |
            A sequence of one or more base 64 (url-safe) uuid substrings.
            These substrings are separated by dots (.).
          example: AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA
          format: SubLocationsHierarchyKey
          nullable: true
          pattern: ^([A-Za-z0-9\-_]{22})([.][A-Za-z0-9\-_]{22})*$
          type: string
        thumbnailLocation:
          nullable: true
          type: string
        thumbnailUri:
          nullable: true
          type: string
        timestampMs:
          format: int64
          nullable: true
          type: integer
        trackId:
          format: int32
          nullable: true
          type: integer
      type: object
    ActivityEnum:
      enum:
        - SOUND_LOUD
        - SOUND_GUN_SHOT
        - TAMPER
        - VISUAL_TAMPER
        - MOTION_TAMPER
        - MOTION
        - MOTION_HUMAN
        - MOTION_CAR
        - MOTION_ANIMAL
        - MOTION_PACKAGE
        - PACKAGE_ARRIVED
        - PACKAGE_DEPARTED
        - FACE
        - FACE_IDENTIFIED
        - FACE_UNIDENTIFIED
        - FACE_BLACKLISTED
        - FACE_ALERT
        - POSE_ANOMALOUS
        - POSE_FALL
        - LICENSEPLATE
        - LICENSEPLATE_IDENTIFIED
        - LICENSEPLATE_UNIDENTIFIED
        - LICENSEPLATE_ALERT
        - LICENSEPLATE_BLACKLISTED
        - LICENSEPLATE_TRUSTED
        - PEOPLECOUNT_HIGH
        - PEOPLECOUNT_HIGH_RESET
        - PEOPLECOUNT_LOW
        - PEOPLECOUNT_LOW_RESET
        - HUMAN_ENTER
        - HUMAN_EXIT
        - CAR_ENTER
        - CAR_EXIT
        - TEMPERATURE_EXCEEDED_HIGH
        - TEMPERATURE_EXCEEDED_LOW
        - HUMIDITY_EXCEEDED_HIGH
        - HUMIDITY_EXCEEDED_LOW
        - PM25_EXCEEDED_HIGH
        - TVOC_EXCEEDED_HIGH
        - ETOH_EXCEEDED_HIGH
        - IAQ_EXCEEDED_HIGH
        - CO2_EXCEEDED_HIGH
        - CO2_EXCEEDED_LOW
        - PROBE_TEMPERATURE_EXCEEDED_HIGH
        - PROBE_TEMPERATURE_EXCEEDED_LOW
        - PROBE_DISCONNECTED
        - PROBE_CONNECTED
        - HEAT_INDEX_EXCEEDED_HIGH
        - PRESSURE_EXCEEDED_HIGH
        - PRESSURE_EXCEEDED_LOW
        - PM10_EXCEEDED_HIGH
        - PM40_EXCEEDED_HIGH
        - PM100_EXCEEDED_HIGH
        - VOC_IDX_EXCEEDED_HIGH
        - NOX_IDX_EXCEEDED_HIGH
        - FORMALDEHYDE_EXCEEDED_HIGH
        - CARBON_MONOXIDE_EXCEEDED_HIGH
        - AQI_EXCEEDED_HIGH
        - DOOR_AJAR
        - DOOR_OPENED
        - DOOR_CLOSED
        - BUTTON_SINGLE_PRESSED
        - BUTTON_DOUBLE_PRESSED
        - BUTTON_LONG_PRESSED
        - TAG_ARRIVED
        - TAG_DEPARTED
        - TAG_MOVED
        - TAG_POSITIONING_CHANGED
        - TAG_BOUNDARY_INGRESS
        - TAG_BOUNDARY_EGRESS
        - TAG_PANIC
        - BADGE_AUTHORIZED
        - BADGE_UNAUTHORIZED
        - BADGE_UNAUTHORIZED_V2
        - BADGE_AJAR
        - BADGE_MANUAL
        - BADGE_FORCED_OPEN
        - BADGE_LOCKDOWN
        - BADGE_REQUEST_TO_EXIT
        - BADGE_DURESS
        - BADGE_SECURITY_BREACH
        - BADGE_TAMPER
        - BADGE_FACE_MISMATCH
        - POS_ORDER
        - GUN_DETECT_EVENT
        - IOT_SOUND_AGGRESSION
        - IOT_SOUND_HELP
        - IOT_AIR_CO
        - IOT_AIR_CO2
        - IOT_AIR_MASKING
        - IOT_AIR_THC
        - IOT_AIR_VAPE
        - IOT_AIR_VOC
        - IOT_AIR_TEMP
        - IOT_TAMPER
        - IOT_GUNSHOT
        - IOT_BUTTON_SINGLE_CLICK
        - IOT_BUTTON_DOUBLE_CLICK
        - IOT_BUTTON_HOLD
        - IOT_PANIC_BUTTON_TRIGGERED
        - AUDIO_SOUND_SIGNIFICANT
        - AUDIO_SOUND_LOUD
        - AUDIO_SOUND_ABUSIVE
        - AUDIO_SOUND_GREETING
        - AUDIO_SOUND_HELP
        - AUDIO_SOUND_GUN
        - AUDIO_SOUND_GLASS_BREAK
        - AUDIO_SOUND_ALARM_SMOKE_FIRE
        - AUDIO_SOUND_ALARM_CARBON_MONOXIDE
        - AUDIO_SOUND_SIREN
        - CLIMATE_VOC
        - CLIMATE_VAPE
        - CLIMATE_SMOKE
        - CLIMATE_THC
        - CLIMATE_CO2
        - CLIMATE_ETOH
        - CLIMATE_PM25
        - CLIMATE_IAQ
        - CLIMATE_LEAK
        - SOUND_AGGRESSION
        - SOUND_HELP
        - AIR_CO
        - AIR_CO2
        - AIR_MASKING
        - AIR_THC
        - AIR_VAPE
        - AIR_VOC
        - MASK_MISSING
        - HELMET_MISSING
        - GLOVES_MISSING
        - PIR_OCCUPIED
        - PIR_MOVEMENT
        - PIR_VACANT
        - CUSTOM
        - VISITOR_ARRIVED
        - VISITOR_DEPARTED
        - AC_DR_CONNECTED
        - AC_DR_DISCONNECTED
        - AC_DPI_DOOR_OPEN
        - AC_DPI_DOOR_CLOSED
        - AC_DPI_DOOR_AJAR
        - AC_DPI_DOOR_FORCED_OPEN
        - AC_DSR_UNLOCKED
        - AC_DSR_LOCKED
        - AC_DB_TRIGGERED
        - AC_PANIC_BUTTON_TRIGGERED
        - AC_REMOTE_UNLOCK
        - AC_BADGE_AUTHORIZED
        - AC_BADGE_UNAUTHORIZED
        - AC_BADGE_FACE_MISMATCH
        - AC_LOCKDOWN_ACTIVATED
        - AC_LOCKDOWN_DEACTIVATED
        - AC_LOCKDOWN_PLAN_SWITCHED
        - AC_TAMPER_PROX
        - AC_TAMPER_ACCEL
        - AC_TAMPER_SWITCH
        - AC_GR_ACTIVE
        - AC_GR_INACTIVE
        - AC_GI_ACTIVE
        - AC_GI_INACTIVE
        - AC_REX_ACTIVE
        - AC_REX_INACTIVE
        - AC_APERIO_DEVICE_DISCONNECTED
        - AC_APERIO_DEVICE_CONNECTED
        - AC_APERIO_DEVICE_REBOOT
        - AC_APERIO_DEVICE_TAMPER
        - AC_APERIO_LOW_BATTERY
        - AC_APERIO_FLAT_BATTERY
        - AC_APERIO_OK_BATTERY
        - AC_SCHLAGE_GW_DISCONNECTED
        - AC_SCHLAGE_GW_CONNECTED
        - AC_SCHLAGE_APM_DISCONNECTED
        - AC_SCHLAGE_APM_CONNECTED
        - AC_SCHLAGE_LOW_BATTERY
        - AC_SCHLAGE_CRITICAL_BATTERY
        - AC_SCHLAGE_OK_BATTERY
        - POWER_SWITCH_BATTERY
        - POWER_SWITCH_PRIMARY
        - AI_SEARCH_MATCH
        - AI_SEARCH_MATCH_PERSON_SMOKING
        - AI_SEARCH_MATCH_PERSON_ON_PHONE
        - AI_SEARCH_MATCH_PERSON_FALLING
        - CUSTOM_LLM_BOOLEAN_TRUE
        - CUSTOM_LLM_BOOLEAN_FALSE
        - CUSTOM_LLM_THRESHOLD_EXCEEDED_LOW
        - CUSTOM_LLM_THRESHOLD_EXCEEDED_HIGH
        - ALM_AUTHORITIES_CONTACTED
        - ALM_MONITORING_ENABLED
        - ALM_MONITORING_DISABLED
        - ALM_MONITORING_SETTINGS_CHANGE
        - ALM_THREAT_CASE_CLOSED
        - ALM_THREAT_DETECTED
        - ALM_MONITORING_EVENT_DETECTED
        - ROBOT_DOG_DETECTED
        - ROBOT_ARRIVED_AT_WAYPOINT
        - ROBOT_ARRIVED_AT_POSE
        - ROBOT_WAITING_AT_POSE
        - ROBOT_MANUAL_CMD_VEL
        - ROBOT_MANUAL_ACTION
        - ROBOT_MANUAL_POSTURE
        - ROBOT_NAVIGATE_TO_POSE_START
        - ROBOT_NAVIGATE_TO_POSE_END
        - ROBOT_NAVIGATE_TO_HOME_START
        - ROBOT_NAVIGATE_TO_HOME_END
        - ROBOT_NAVIGATE_TO_WAYPOINT_START
        - ROBOT_NAVIGATE_TO_WAYPOINT_END
        - ROBOT_ROUTE_RUN_START
        - ROBOT_ROUTE_RUN_END
        - ROBOT_LOW_BATTERY_DOCKING
        - ROBOT_IDLE_DOCKING
        - ROBOT_EMERGENCY
        - LOITER_HUMAN
        - INACTIVITY_HUMAN
        - INACTIVITY_CAR
        - GROUP_ENTRY
        - ONGUARD_BADGE_AUTHORIZED
        - ONGUARD_BADGE_ANOMALY
        - ONGUARD_NO_ENTRY_MADE
        - ELEMENTS_BADGE_AUTHORIZED
        - ELEMENTS_BADGE_ANOMALY
        - ELEMENTS_NO_ENTRY_MADE
        - NETBOX_BADGE_AUTHORIZED
        - NETBOX_BADGE_ANOMALY
        - NETBOX_NO_ENTRY_MADE
        - THERMAL_TEMPERATURE_ALARM
        - THERMAL_TEMPERATURE_WARNING
        - THERMAL_FIRE_DETECTED
        - THERMAL_SMOKING_DETECTED
        - THERMAL_FIRE_VERIFIED
        - THERMAL_HEAT_NO_THREAT
        - THERMAL_VISUAL_HOTSPOT
        - THERMAL_VISUAL_HEAT_RISE
        - THERMAL_VISUAL_WARM_BODY
        - UNKNOWN
      type: string
    PolicyEventFaceType:
      nullable: true
      properties:
        faceId:
          nullable: true
          type: string
        faceName:
          nullable: true
          type: string
        imageS3Bucket:
          nullable: true
          type: string
        imageS3Key:
          nullable: true
          type: string
        imageS3Region:
          nullable: true
          type: string
        labels:
          items:
            nullable: true
            type: string
          nullable: true
          type: array
          uniqueItems: true
        personUuid:
          description: base 64 (url-safe) uuid string
          example: AAAAAAAAAAAAAAAAAAAAAA
          format: RUUID
          nullable: true
          type: string
      type: object
    PolicyEventVehicleType:
      nullable: true
      properties:
        imageS3Bucket:
          nullable: true
          type: string
        imageS3Key:
          nullable: true
          type: string
        imageS3Region:
          nullable: true
          type: string
        labels:
          items:
            nullable: true
            type: string
          nullable: true
          type: array
          uniqueItems: true
        licensePlateNumber:
          nullable: true
          type: string
        vehicleName:
          nullable: true
          type: string
      type: object
    MetaDataLocationType:
      properties:
        region:
          nullable: true
          type: string
      type: object
    CheckCondition:
      nullable: true
      properties:
        operator:
          $ref: "#/components/schemas/OPERATOREnum"
        value:
          nullable: true
          type: string
      type: object
    OPERATOREnum:
      enum:
        - GT
        - LT
        - LTE
        - GTE
        - EQ
        - CONTAINS
      type: string
    PromptTypeEnum:
      enum:
        - COUNT
        - PERCENT
        - BOOLEAN
        - TEXT
      type: string
    DeviceTypeEnum:
      enum:
        - BLE_TRACKER
        - CAMERA
        - DOOR_SENSOR
        - ENVIRONMENTAL_SENSOR
        - OCCUPANCY_SENSOR
        - AUDIO_GATEWAY
        - EXECUTABLE
        - BADGE_READER
        - DOOR_CONTROLLER
        - BLE_BUTTON
        - IO_BOARD
        - ENVIRONMENTAL_GATEWAY
        - NVR
        - ROBOT
        - UNKNOWN
      type: string
    ApiClientTypeEnum:
      enum:
        - PARTNER_DEVELOPER
        - DEVELOPER
        - DOOR_STATION
        - INTERNAL_SALESFORCE
        - TVOS
        - WINDOWS
        - LINUX
        - KIOSK
        - KEYPAD
        - SQUARE
        - KISI
        - OPENPATH
        - TOAST
        - BOULEVARD
        - BRIVO
        - EXECUTABLE
        - HALO
        - SALTO
        - BUTTERFLYMX
        - GENEA
        - PRODATAKEY
        - ENVOY
        - AMT
        - PIMLOC
        - PLACEOS
        - OMNIALERT
        - FLIC
        - SHELLY_DEVICE_EVENT
        - NINEONEONECELLULAR
        - HONEYWELL_ELEMENTS
        - HONEYWELL_ONGUARD
        - HONEYWELL_NETBOX
        - TRITON
        - CHATBOT
        - SIGNATURE_API
        - INCOMING_WEBHOOK
        - UNKNOWN
      type: string
    PolicyAlertEnumType:
      enum:
        - POLICY_ALERT_V2
        - ACCESS_CONTROLLED_DOOR_POLICY_ALERT
      type: string
  securitySchemes:
    ApiKeyAuth:
      description: Your Rhombus API key. Must be accompanied by the `x-auth-scheme` header set to `api-token` (or `partner-api-token` for partner endpoints).
      in: header
      name: x-auth-apikey
      type: apiKey
    oauth2:
      description: 'OAuth 2.0 authorization code flow with PKCE (`S256`). Send the access token as `Authorization: Bearer <token>`. Each operation lists the scopes it requires; a token without them is refused 403 with `WWW-Authenticate: Bearer error="insufficient_scope"`.'
      flows:
        authorizationCode:
          authorizationUrl: https://console.rhombus.com/oauth/authorize
          refreshUrl: https://auth-web.rhombussystems.com/oauth/token
          scopes:
            physical: Unlock doors and elevators, lockdown, alarms, speakers and robots
            read: View cameras, footage and settings
            write: Change settings and data
          tokenUrl: https://auth-web.rhombussystems.com/oauth/token
      type: oauth2
````