Execute record deletion

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

Execute record deletion in Dynatrace with the Grail Storage Record Deletion API using DQL and a time frame. It accepts the request for asynchronous processing.

Overview

Execute record deletion. Removing data depends on the load and can be very time-consuming.

Timeframe length is limited to 24 hours. ISO-8601 and RFC-3339 are recommended to use. Additionally, end time must end at least 4 hours from now.

Subsequent record deletion requests are queued and executed in the order of their arrival.

Allowed query commands: fetch, fields, fieldsAdd, fieldsRemove, filter, parse

Allowed query functions: concat, contains, timestamp, timeframe, asNumber, asDouble, asLong, asString, asBoolean, toDouble, toLong, toString, toBoolean, now, matchesPhrase, matchesValue, matchesPattern

The fetch command parameters scanLimitGBytes and samplingRatio aren't available in the Record Deletion API.

Authentication

To execute this request, you need a platform token or OAuth access token with all of the following scopes:

To learn how to obtain and use it, see Tokens and authentication.

Parameters

{
  "query": "fetch logs | filter contains(content, \"delete_records_test\")",
  "timeFrame": {
    "start": "2023-04-04T00:00:00",
    "end": "2023-04-04T01:00:00"
  },
  "timezone": "UTC",
  "locale": "en-US"
}

Response

{
  "error": {
    "code": 1,
    "errorDetails": [
      {
        "message": "string"
      }
    ],
    "message": "string"
  }
}