Define, create, update, and delete Grail Filter Segments in Dynatrace to constrain query scope with custom data filters and lean entity models.
Use the @dynatrace-sdk/client-filter-segment-management SDK client instead of calling this API directly — it handles authentication, typing, and the environment URL for you. This REST reference is for external and automation use.
Dynatrace Grail - Filter Segments lets you define and manage reusable filter segments that constrain query scope with custom data filters. Use it to create, inspect, update, and delete segments, or to retrieve them in full or lean form when you need a lighter response. Typical usage includes organizing common filtering logic for Grail queries, keeping access and analysis scopes consistent, and adjusting segment definitions as data or requirements change.
Platform API endpoints use Platform token and OAuth client authentication. Attach a platform token or OAuth access token to the Authorization HTTP header using the Bearer scheme.
--header 'Authorization: Bearer <platform-token-or-oauth-access-token>'
For details, see Tokens and authentication and Platform tokens.
GET /filter-segments)POST /filter-segments)GET /filter-segments-entity-model)GET /filter-segments/{filterSegmentUid})PUT /filter-segments/{filterSegmentUid})DELETE /filter-segments/{filterSegmentUid})PATCH /filter-segments/{filterSegmentUid})GET /filter-segments:lean)