Cancel a record deletion task

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

Cancel an in-progress record deletion task in Dynatrace with the Grail Storage Record Deletion API. It stops queued subtasks and returns accepted cancellation.

Overview

You provide the taskId in the request body to cancel a submitted record deletion process. Dynatrace cancels subtasks that have not started yet and returns an accepted response for the cancellation request.

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

{
  "taskId": "49eb7d8e-806a-4829-9d29-c2a92e642366"
}

Response

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