Versions And Prompt Review
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.
POST
Acknowledge A Prompt Review Finding
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
acceptedwhen the finding is valid and the team has intentionally decided to live with it. - Use
dismissedwhen 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 and keep the finding’sfingerprint and kind. Send the agent ID that produced that review; it must be an agent in your workspace.
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 returnsupdated: 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 requestedfinding_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
Related Lifecycle Operations
- Review An Agent Prompt to get findings and fingerprints.
- Update Agent to fix a draft finding.
- Agent Versions And Publishing for the dashboard workflow.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Signed agent ID of an agent in your workspace.
Body
application/json
The finding's own fingerprint (sha1 hex), from the review response.
Pattern:
^[0-9a-f]{40}$The finding kind at ack time (contradiction, hallucination_risk, ...).
Maximum string length:
40Available options:
accepted, dismissed