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

# Update Potential Match Status

> Updates the review status of a potential match returned by a search. Use this endpoint after an analyst or downstream workflow has reviewed a search result and needs to record the disposition.

Supported `review_status` values:
- `unresolved`: the potential match still needs review.
- `true_positive`: the potential match has been confirmed as a true match.
- `false_positive`: the potential match has been determined not to match the screened profile.
- `suppressed`: the potential match is a repeated or previously known result with no material change.
- `closed`: the potential match is closed and no longer part of the active review queue.
- `reopened`: the potential match has been reopened for review.



## OpenAPI

````yaml /api-reference/profiles.json patch /v2/search/matches/{match_id}
openapi: 3.1.0
info:
  title: Profiles API
  version: 1.0.0
  description: >-
    Customer-facing API endpoints for managing screening profiles and updating
    potential match review workflows.
servers:
  - description: The production API server for Minerva AI for managing screening profiles
    url: https://api.gominerva.com/clm/v1
security: []
tags:
  - name: Profile Management
    description: Create, list, update, and comment on screening workflow profiles.
  - name: Potential Matches
    description: Update review workflow state for potential matches returned by searches.
externalDocs:
  description: ''
  url: ''
paths:
  /v2/search/matches/{match_id}:
    patch:
      tags:
        - Potential Matches
      summary: Update Potential Match Status
      description: >-
        Updates the review status of a potential match returned by a search. Use
        this endpoint after an analyst or downstream workflow has reviewed a
        search result and needs to record the disposition.


        Supported `review_status` values:

        - `unresolved`: the potential match still needs review.

        - `true_positive`: the potential match has been confirmed as a true
        match.

        - `false_positive`: the potential match has been determined not to match
        the screened profile.

        - `suppressed`: the potential match is a repeated or previously known
        result with no material change.

        - `closed`: the potential match is closed and no longer part of the
        active review queue.

        - `reopened`: the potential match has been reopened for review.
      parameters:
        - description: Potential match ID returned by Minerva search results.
          in: path
          name: match_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdatePotentialMatchStatusRequest'
        description: Potential match status update request
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PotentialMatchStatusUpdateResponse'
          description: Potential match status updated successfully
      security:
        - ApiKeyAuth: []
      servers:
        - url: https://api.gominerva.com
          description: The production API server for Minerva AI
components:
  schemas:
    UpdatePotentialMatchStatusRequest:
      description: >-
        Request body for updating the review status of a potential match
        returned by a search.
      required:
        - review_status
      properties:
        review_status:
          description: New review status for the potential match.
          enum:
            - unresolved
            - true_positive
            - false_positive
            - suppressed
            - closed
            - reopened
          example: false_positive
          type: string
      type: object
    PotentialMatchStatusUpdateResponse:
      properties:
        match:
          properties:
            id:
              description: Potential match ID.
              example: 665f1c2b16f5adbb8e1d3f41
              type: string
            review_status:
              description: Updated review status.
              enum:
                - unresolved
                - true_positive
                - false_positive
                - suppressed
                - closed
                - reopened
              example: false_positive
              type: string
          type: object
      type: object
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        The Minerva API key used for this integration. Manage API keys in the
        Minerva dashboard under Administration > Developers.

````