List record deletion tasks

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

List record deletion tasks in Dynatrace with the Grail Storage Record Deletion API, ordered by submission time and including taskId for follow-up.

Overview

You use the taskId from the request body to list record deletion tasks in Dynatrace. The response returns all deletion tasks ordered by submission time, and each entry includes the same fields as delete:status plus taskId for use with delete:status or delete:cancel.

Authentication

To execute this request, you need a platform token or OAuth access token with storage:records:delete scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

The request doesn't provide any configurable parameters.

Response

[
  {
    "taskId": "ff66cae6-fb68-4f95-ba19-920a401e6182",
    "status": "finished",
    "message": "Records deletion has been successfully completed. 1234567 byte(s) have been rewritten.",
    "rewrittenBytes": 1234567
  },
  {
    "taskId": "0a67d04a-d9f4-4062-ba4f-8c97a1ad5be4",
    "status": "processing",
    "message": "Deletion job is being processed.",
    "progress": "21%"
  }
]