Update a bucket

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

Update a bucket definition in Dynatrace with the Grail Storage Management API using the bucket name, optimistic locking version, and changed fields.

Overview

You provide the bucketName path parameter and the optimistic-locking-version query parameter, then send the fields to update in the request body. The operation updates the bucket definition and returns the updated result.

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

{
  "bucketName": "custom_logs",
  "table": "logs",
  "displayName": "Custom logs bucket (updated)",
  "status": "active",
  "retentionDays": 10,
  "includedQueryLimitDays": 0,
  "version": 1
}

Response

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