Permanently delete a bucket

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

Permanently delete a bucket in Dynatrace with the Grail Storage Management API, removing its content first and then the bucket itself.

Overview

ATTENTION - This operation is irreversible

Delete can be used to delete a bucket. This operation will remove the content of a given bucket and then delete the bucket itself.

Delete is an asynchronous task. Runtime will depend on the amount of data that has to be removed.

The status of this operation can be tracked via the status field within the GET bucket definitions or GET bucket definition. Status will show deleting as long as data will be drained and finally the bucket will be deleted. Afterwards the bucket will cease to exist.

Operation can be executed on all types of buckets except buckets where bucketName starts with dt_ or default_.

Before a bucket is deleted, checks are performed to verify that the bucket is not in use.

Authentication

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

Parameters

Response

{
  "error": {
    "code": 400,
    "message": "Missing request header",
    "errorDetails": [
      {
        "type": "parameter",
        "parameterDescriptor": "Dt-Tenant",
        "message": "is required"
      }
    ]
  }
}