Update a fieldset

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

Update a fieldset in Dynatrace with the Grail Fieldsets API by replacing its definition, using the UID and optimistic locking version.

Overview

You must supply the fieldsetUid path parameter and the optimistic-locking-version query parameter to apply the update to the correct base version. The request body can include buckets, description, enabled, fields, scope, and tables, and the operation returns 200 when the fieldset is successfully updated.

Authentication

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

Parameters

{
  "description": "Sensitive field set on table",
  "enabled": true,
  "scope": "TABLE",
  "fields": [
    "email",
    "userid"
  ],
  "tables": [
    "spans",
    "logs"
  ]
}

Response

{
  "error": {
    "message": "Constraint Violations",
    "details": {
      "constraintViolations": [
        {
          "message": "size must be between 0 and 512",
          "parameterDescriptor": "description"
        }
      ]
    },
    "code": 400
  }
}