Partially update a bucket

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

Partially update a bucket definition in Dynatrace with the Grail Storage Management API by changing displayName, includedQueryLimitDays, or retentionDays.

Overview

You update a bucket definition by providing the bucketName path parameter and the optimistic-locking-version query parameter. In the request body, include the fields you want to change: displayName, includedQueryLimitDays, or retentionDays. The operation returns a successfully updated bucket definition.

Authentication

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

Parameters

{
  "displayName": "Custom logs bucket (updated)",
  "retentionDays": 10,
  "includedQueryLimitDays": 0
}

Response

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