Delete a filter segment

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

Delete a filter segment in Dynatrace with the Grail Filter Segments API by UID and remove it from the environment for all users.

Overview

You provide the filterSegmentUid path parameter to identify the filter segment to remove. The operation deletes it from the environment for all users and returns no content.

Authentication

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