Agents
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.
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 returned by a previous prompt review.
Example:
"agent_2g7Xy3tY53gRlp"
Body
application/json
Response
Finding acknowledgement stored.
Acknowledge A Prompt Review Finding