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

# Add Profile Comment

> Adds a comment to a screening profile. Comments are useful for recording analyst rationale, follow-up notes, and review context alongside the profile record.

Supported `kind` values:
- `profile`: a general note on the profile.
- `match`: a note associated with a potential match. Include `matchId` when available.



## OpenAPI

````yaml /api-reference/profiles.json post /profiles/{profileId}/comments
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:
  /profiles/{profileId}/comments:
    post:
      tags:
        - Profile Management
      summary: Add Profile Comment
      description: >-
        Adds a comment to a screening profile. Comments are useful for recording
        analyst rationale, follow-up notes, and review context alongside the
        profile record.


        Supported `kind` values:

        - `profile`: a general note on the profile.

        - `match`: a note associated with a potential match. Include `matchId`
        when available.
      parameters:
        - description: Profile ID that should receive the comment.
          in: path
          name: profileId
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/clm.ProfileCommentCreateRequest'
        description: Profile comment creation request
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/clm.CreateProfileCommentResponse'
          description: Comment created successfully
      security:
        - ApiKeyAuth: []
components:
  schemas:
    clm.ProfileCommentCreateRequest:
      description: >-
        Request body for adding an analyst comment to a profile. Use `kind` to
        indicate whether the note is profile-level or tied to a potential match.
      required:
        - text
        - kind
      properties:
        text:
          description: Comment text. Must be a non-empty string.
          example: >-
            Reviewed the sanctions hit and determined it is a false match
            because the date of birth does not align.
          type: string
        kind:
          description: >-
            Comment category. Use `profile` for a general profile note or
            `match` for a potential match note.
          enum:
            - profile
            - match
          example: profile
          type: string
        matchId:
          description: >-
            Optional potential match ID to associate with the comment when
            `kind` is `match`.
          example: 665f1c2b16f5adbb8e1d3f41
          type: string
      type: object
    clm.CreateProfileCommentResponse:
      properties:
        msg:
          example: OK
          type: string
        result:
          properties:
            comment:
              $ref: '#/components/schemas/clm.ProfileCommentResponse'
          type: object
        status:
          example: 201
          type: integer
      type: object
    clm.ProfileCommentResponse:
      properties:
        _v:
          example: 1
          type: integer
        id:
          description: Comment ID.
          example: 66c391b92888a0db5cc6d3f7
          type: string
        createdAt:
          description: Timestamp when the comment was created.
          example: '2026-05-22T15:30:00Z'
          type: string
        updatedAt:
          description: Timestamp when the comment was last updated.
          example: '2026-05-22T15:30:00Z'
          type: string
        text:
          description: Comment text.
          example: >-
            Reviewed the sanctions hit and determined it is a false match
            because the date of birth does not align.
          type: string
        kind:
          description: Comment category.
          enum:
            - profile
            - match
          example: profile
          type: string
        matchId:
          description: Associated potential match ID, when present.
          example: 665f1c2b16f5adbb8e1d3f41
          type: string
        profileId:
          description: Profile ID that owns the comment.
          example: 66c391b92888a0db5cc6d3f6
          type: string
        createdBy:
          description: ID of the agent that created the comment.
          example: core-user-id
          type: string
        updatedBy:
          description: ID of the agent that last updated the comment, when present.
          example: core-user-id
          type: string
      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.

````