Delete a fieldset by UID in Dynatrace with the Grail Fieldsets API, removing the fieldset definition used for field-level access control.
| DELETE | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/storage/fieldsets/v1/fieldsets/{fieldsetUid} |
You use the fieldsetUid path parameter to identify the fieldset you want to delete. The operation returns no content and confirms the fieldset was successfully deleted with a 204 response.
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.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| fieldsetUid | string | UID of the fieldset | path | Required |
| Code | Type | Description |
|---|---|---|
| 204 | - | fieldset successfully deleted. |
| 404 | Error | Not found: the server cannot find the requested fieldset. |
| 5XX | Error | Server error. |
ErrorEnvelope object| Element | Type | Description |
|---|---|---|
| error | Error | The response for error state |
ErrorResponse objectThe response for error state
| Element | Type | Description |
|---|---|---|
| code | integer | Error code, which normally matches the HTTP error code. |
| details | Error | Detailed information about the error. |
| message | string | A short, clear error message without details |
ErrorResponseDetails objectDetailed information about the error.
| Element | Type | Description |
|---|---|---|
| constraintViolations | Error | Information about an input parameter that violated some validation rule of the service API. |
| errorMessage | string | Complete error message. |
| missingPermissions | string[] | List of missing IAM permissions necessary to successfully execute the request. |
| missingScopes | string[] | List of missing IAM scopes necessary to successfully execute the request. |
ErrorResponseDetailsConstraintViolations objectInformation about an input parameter that violated some validation rule of the service API.
| Element | Type | Description |
|---|---|---|
| message | string | Message describing the error. |
| parameterDescriptor | string | Describes the violating parameter. |
{"error": {"message": "Fieldset not found","code": 404}}