> ## 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.

# Cancel threat case

> Cancel a threat case in alert monitoring.



## OpenAPI

````yaml https://api2.rhombussystems.com/api/openapi/public.json post /api/alertmonitoring/cancelThreatCase
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/cancelThreatCase:
    post:
      tags:
        - Alert Monitoring Webservice
      summary: Cancel threat case
      description: Cancel a threat case in alert monitoring.
      operationId: cancelThreatCase
      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_CancelThreatCaseWSRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Alertmonitoring_CancelThreatCaseWSResponse
          description: OK
      deprecated: true
components:
  schemas:
    Alertmonitoring_CancelThreatCaseWSRequest:
      type: object
      description: Request to cancel a threat case in 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_CancelThreatCaseWSResponse:
      type: object
      description: Response indicating the result of canceling a threat case.
      properties:
        error:
          type: boolean
          nullable: true
        errorMsg:
          type: string
          nullable: true
        success:
          type: boolean
          description: Indicates whether the threat case cancellation was successful
          example: true
          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.