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

# Cascade Mark Hits

> Cascade assessment to all hits matching a specific subject, external ID, and engine.

Use this endpoint to cascade the same assessment decision to all NameScreenHits that match the specified `client_subject_id`, `external_id`, and `engine`. This is useful when you want to apply the same assessment across all transactions for a given subject from a specific screening engine.

**Assessment Decisions:**

* `TRUE_HIT` — Confirmed as a true hit
* `FALSE_HIT` — Confirmed as a false hit


## OpenAPI

````yaml post /api/namescreenhits/mark-as-cascade
openapi: 3.0.3
info:
  title: Athena API
  version: v3
  x-logo:
    url: https://cynopsis.co/wp-content/uploads/2021/03/logo-2.png
    altText: Cynopsis Solutions
  description: >-
    ATHENA is an advanced real-time transaction monitoring solution designed to
    detect and prevent money laundering, fraud, and terrorism financing. Powered
    by proprietary AML rules, ATHENA analyzes transactions in real time,
    providing clear, intuitive visual insights to streamline compliance
    processes.
        
        ✅ Real-Time Monitoring – Instantly analyzes transaction data to detect anomalies and potential compliance risks.
        ✅ Visualized Insights – Converts complex data into easy-to-understand charts, aiding faster decision-making.
        ✅ Seamless Integration – Easily integrates with existing financial and compliance systems.
        
        Ideal for financial institutions, fintech companies, and regulated businesses, ATHENA enhances risk management and ensures regulatory compliance with ease.
  contact:
    email: tech@cynopsis.co
servers:
  - url: http://localhost/api
    description: Local development server
security: []
paths:
  /api/namescreenhits/mark-as-cascade:
    post:
      tags:
        - Name Screen Hits
      summary: Cascade mark name screen hits
      description: >-
        Cascade assessment to all hits matching client_subject_id, external_id,
        and engine.


        This endpoint updates all NameScreenHits that match the specified

        client_subject_id, external_id, AND engine with the provided assessment
        decision.

        This allows cascading the same assessment to a specific watchlist entity
        from a

        specific screening engine across all transactions for a given subject.


        Request Body:
            - client_subject_id (str): The subject ID to cascade to
            - external_id (str): The external ID from screening engine (DJ ID, TR ID, etc.)
            - engine (str): The screening engine (DJ, TR, ARTEMISCAN)
            - mark_as (str): Assessment decision (NO_ACTION, TRUE_HIT, FALSE_HIT)
            - comment (str, optional): Comment for the assessment

        Returns:
            - success (bool): Whether the operation succeeded
            - hits_updated (int): Number of hits updated
            - updated_hit_ids (list): List of updated hit IDs
            - breakdown (dict): Count of hits per engine
            - message (str): Success or error message
      operationId: namescreenhitassessment_mark_as_cascade
      responses:
        '200':
          description: No response body
      security:
        - cookieAuth: []
        - BearerAuth: []
components:
  securitySchemes:
    cookieAuth:
      type: apiKey
      in: cookie
      name: sessionid

````