Submit DQL explanation feedback

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

Submit feedback for a DQL explanation in Dynatrace with the DQL2NL API, including the message token, origin, feedback, and optional response details.

Overview

Allows to provide feedback to a dql2nl response. The payload is a JSON dictionary combining feedback and information from the dql2nl response. Please review the examples for the correct payload formatting.

Parameters:

Please note, this endpoint is in preview and is subject to the Dynatrace preview conditions, as linked in the overview.

Authentication

To execute this request, you need a platform token or OAuth access token with davis-copilot:dql2nl:execute scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

{
  "messageToken": "string",
  "origin": "Notebooks DQL to NL feedback",
  "feedback": {
    "type": "positive",
    "text": "The DQL statement was not correct.",
    "category": "misunderstood",
    "improvement": {
      "text": "The DQL statement should have shown me metadata for the logs source.",
      "confirmation": true
    }
  },
  "userQuery": "describe logs",
  "queryExplanation": "Show me the metadata of the logs data source."
}

Response

{
  "error": {
    "code": 400,
    "message": "Bad Request"
  }
}