> ## Documentation Index > Fetch the complete documentation index at: https://dialnexa.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Acknowledge A Prompt Review Finding > Accept or dismiss one DialNexa agent prompt review finding so it stays hidden in later reviews of the same agent. Changes state - verify before retry Accept or dismiss one agent prompt review finding. The decision applies to the agent across versions, sessions, and workspace teammates, so future reviews do not keep presenting a finding your team already evaluated. ## When To Use A Prompt Review Acknowledgement * Use `accepted` when the finding is valid and the team has intentionally decided to live with it. * Use `dismissed` when the finding does not apply to this agent. * Do not acknowledge a finding merely to clear the review. Revise the draft when the warning reveals a real issue that should be fixed. ## Before You Call It Run [Review An Agent Prompt](/docs/api-reference/v1/agents/review-prompt) and keep the finding's `fingerprint` and `kind`. Send the agent ID that produced that review. | Field | Requirement | | --------------------- | ---------------------------------------------------------------------------------- | | `finding_fingerprint` | The exact 40-character lowercase hexadecimal fingerprint from the review response. | | `kind` | The finding `kind` returned by the review, up to 40 characters. | | `status` | Either `accepted` or `dismissed`. | ## Side Effects And Retry Safety This operation writes a shared acknowledgement for the agent. It does not edit the prompt, create a version, or publish the agent. The operation is idempotent for the same finding fingerprint. A first acknowledgement returns `updated: false`. Repeating it, or changing the decision for that fingerprint, updates the existing record and returns `updated: true`. ## Verify The Result Confirm the response contains the requested `finding_fingerprint`, `kind`, and `status`. The response also includes `acked_at` and, when available, `acked_by`. Run prompt review again and confirm the finding is marked acknowledged or no longer appears as a new warning. ## Operation-Specific Errors | Status | Meaning | What to do | | --------------------------- | --------------------------------------------------- | ----------------------------------------------------------------------------------- | | `400 Bad Request` | The fingerprint, kind, or status failed validation. | Copy the values from the review response and retry. | | `401 Unauthorized` | The API key is missing or invalid. | Send a valid workspace API key. | | `500 Internal Server Error` | The acknowledgement could not be stored. | Retry once. If it continues, keep the finding visible and contact DialNexa support. | ## Related Lifecycle Operations * [Review An Agent Prompt](/docs/api-reference/v1/agents/review-prompt) to get findings and fingerprints. * [Update Agent](/docs/api-reference/v1/agents/update) to fix a draft finding. * [Agent Versions And Publishing](/docs/agents/agent-versions-and-publishing#verify-and-publish-an-agent-version) for the dashboard workflow. ## OpenAPI ````yaml POST /v1/agent-versions/{agentId}/prompt-review/ack openapi: 3.0.0 info: title: DialNexa API description: Public `/v1` REST API for the DialNexa voice AI platform. version: 1.0.0 servers: - url: https://api.dialnexa.com description: DialNexa production API security: - bearer: [] tags: - name: Agents - name: Batch Calls - name: Calls - name: Knowledge Base - name: Languages - name: LLMs - name: Phone Numbers - name: Transcribers - name: Webhooks - name: Voices - name: Workflows - name: Workflow Leads paths: /v1/agent-versions/{agentId}/prompt-review/ack: post: tags: - Agents summary: Acknowledge A Prompt Review Finding description: >- Accepts or dismisses one prompt review finding for future reviews of the same agent. operationId: acknowledgePromptReviewFinding parameters: - name: agentId required: true in: path description: Signed agent ID returned by a previous prompt review. schema: example: agent_2g7Xy3tY53gRlp type: string requestBody: required: true content: application/json: schema: type: object required: - finding_fingerprint - kind - status properties: finding_fingerprint: type: string pattern: ^[0-9a-f]{40}$ description: Finding fingerprint returned by prompt review. kind: type: string maxLength: 40 description: Finding kind returned by prompt review. status: type: string enum: - accepted - dismissed examples: dismissFinding: summary: Dismiss one reviewed finding value: finding_fingerprint: 6a763e1fa5d7c82cbb9e54e10d4232cfdd2423ba kind: undefined_variable status: dismissed responses: '201': description: Finding acknowledgement stored. content: application/json: schema: type: object required: - updated - finding_fingerprint - kind - status - acked_at properties: updated: type: boolean description: True when an existing acknowledgement was updated. finding_fingerprint: type: string pattern: ^[0-9a-f]{40}$ kind: type: string status: type: string enum: - accepted - dismissed acked_by: type: string nullable: true acked_at: type: string format: date-time examples: success: summary: New acknowledgement value: updated: false finding_fingerprint: 6a763e1fa5d7c82cbb9e54e10d4232cfdd2423ba kind: undefined_variable status: dismissed acked_by: null acked_at: '2026-08-31T03:18:00.000Z' '400': description: Invalid finding fingerprint, kind, or status. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - bearer: [] components: schemas: ErrorResponse: type: object properties: statusCode: type: integer example: 400 message: oneOf: - type: string - type: array items: type: string example: phone_number must be a valid E.164 phone number error: type: string example: Bad Request required: - statusCode - message - error securitySchemes: bearer: scheme: bearer type: http ````