Data privacy API - GET configuration

Gets the global configuration of data privacy, affecting all your applications.

The request produces an application/json payload.

GET	Managed	`https://{your-domain}/e/{your-environment-id}/api/config/v1/dataPrivacy`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/config/v1/dataPrivacy`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/dataPrivacy`

Authentication

To execute this request, you need Read configuration (ReadConfig) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Parameters

The request doesn't provide any configurable parameters.

Response

Response codes

Code	Type	Description
200	DataPrivacyAndSecurity	Success

Response body objects

The `DataPrivacyAndSecurity` object

Global configuration for data privacy and security.

Element	Type	Description	Required
metadata	ConfigurationMetadata	Metadata useful for debugging	optional
maskIpAddressesAndGpsCoordinates	boolean	Masking of IP addresses and GPS coordinates is enabled (`true`) or disabled (`false`).	required
maskUserActionNames	boolean	Masking of user action names is enabled (`true`) or disabled (`false`). This masking is available only for web applications.	required
maskPersonalDataInUris	boolean	Masking of personal data in URIs is enabled (`true`) or disabled (`false`).	required
logAuditEvents	boolean	The audit logging is enabled (`true`) or disabled (`false`).	optional

The `ConfigurationMetadata` object

Metadata useful for debugging

Element	Type	Description	Required
currentConfigurationVersions	string[]	A sorted list of version numbers of the configuration.	optional
clusterVersion	string	Dynatrace version.	optional
configurationVersions	integer[]	A sorted list of the version numbers of the configuration.	optional

Response body JSON model

json
{
  "metadata": {
    "currentConfigurationVersions": [
      "1.0.4",
      "1.23"
    ],
    "clusterVersion": "1.192.1",
    "configurationVersions": [
      4,
      2
    ]
  },
  "maskIpAddressesAndGpsCoordinates": true,
  "maskUserActionNames": true,
  "maskPersonalDataInUris": true,
  "logAuditEvents": true
}

Example

In this example, the request fetches the current data privacy configuration.

The API token is passed in the Authorization header.

Curl

bash
curl -X GET \
  https://mySampleEnv.live.dynatrace.com/api/config/v1/dataPrivacy \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

http
https://mySampleEnv.live.dynatrace.com/api/config/v1/dataPrivacy

Response body

json
{
  "metadata": {
    "configurationVersions": [
      17,
      17
      ],
      "clusterVersion": "1.211.2.20210129-043235"
    },
    "maskIpAddressesAndGpsCoordinates": true,
    "maskUserActionNames": false,
    "maskPersonalDataInUris": false,
    "logAuditEvents": true
}