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

# Escalate threat case to alarm

> Escalate a threat case to an alarm for alert monitoring.



## OpenAPI

````yaml https://api2.rhombussystems.com/api/openapi/public.json post /api/alertmonitoring/escalateThreatCaseToAlarm
openapi: 3.0.1
info:
  contact:
    email: developer@rhombussystems.com
  description: >-
    This API is for use by Rhombus customers and partners.


    ## Authentication


    All requests require two headers:

    - `x-auth-scheme` — The authentication scheme identifier. Use `api-token`
    for standard API key auth, or `partner-api-token` for partner API auth.

    - `x-auth-apikey` — Your Rhombus API key.


    Example:

    ```

    POST /api/camera/getMinimalCameraStateList

    x-auth-scheme: api-token

    x-auth-apikey: YOUR_API_KEY

    Content-Type: application/json

    ```
  title: Rhombus API
  version: '1.0'
servers:
  - description: Production Server
    url: https://api2.rhombussystems.com
security:
  - ApiKeyAuth: []
paths:
  /api/alertmonitoring/escalateThreatCaseToAlarm:
    post:
      tags:
        - Alert Monitoring Webservice
      summary: Escalate threat case to alarm
      description: Escalate a threat case to an alarm for alert monitoring.
      operationId: escalateThreatCaseToAlarm
      parameters:
        - description: >-
            Authentication scheme identifier. Use `api-token` for standard API
            key authentication, `partner-api-token` for partner API key
            authentication. Must be paired with the `x-auth-apikey` header
            containing your API key.
          example: api-token
          in: header
          name: x-auth-scheme
          required: true
          schema:
            type: string
            default: api-token
            enum:
              - api-token
              - api
              - partner-api-token
              - partner-api
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/Alertmonitoring_EscalateThreatCaseToAlarmWSRequest
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Alertmonitoring_EscalateThreatCaseToAlarmWSResponse
          description: OK
      deprecated: true
components:
  schemas:
    Alertmonitoring_EscalateThreatCaseToAlarmWSRequest:
      type: object
      description: Request to escalate a threat case to an alarm for alert monitoring.
      properties:
        authenticatePin:
          type: boolean
          description: >
            When true, the server authenticates the provided PIN against the
            threat case's zone and rejects

            the request if authentication fails. Expected from clients that
            cannot identify their caller

            such as alarm pads.
          nullable: true
        pin:
          type: string
          description: >
            Optional PIN used to authenticate this request and identify the
            initiating user or group.

            Only honored when authenticatePin is true; otherwise ignored.
          nullable: true
        uuid:
          type: string
          format: RUUID
          description: base 64 (url-safe) uuid string
          example: AAAAAAAAAAAAAAAAAAAAAA
          nullable: true
      required:
        - uuid
    Alertmonitoring_EscalateThreatCaseToAlarmWSResponse:
      type: object
      description: Response indicating the result of escalating a threat case to an alarm.
      properties:
        error:
          type: boolean
          nullable: true
        errorMsg:
          type: string
          nullable: true
        warningMsg:
          type: string
          nullable: true
  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

````

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