Empty a bucket

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

Empty a bucket in Dynatrace with the Grail Storage Management API by removing its content asynchronously while keeping the bucket definition.

Overview

ATTENTION - This operation is irreversibly

Truncate can be used to empty a bucket. This operation will remove the content of a given bucket.

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

Operation can be executed on all types of buckets.

Authentication

To execute this request, you need a platform token or OAuth access token with storage:bucket-definitions:truncate 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"
      }
    ]
  }
}