Update synthetic configuration

• Latest Dynatrace
• Reference
• Published Oct 13, 2026
• Early Access

Update tenant-wide synthetic settings in Dynatrace with the Synthetic API, including parameters that affect all monitors and private locations.

Overview

You use the configuration endpoint to change the synthetic-related parameters defined for the whole tenant. The request body can include bmMonitorTimeout and bmStepTimeout, and the operation returns no body when the update succeeds.

Authentication

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

Parameters

{
  "bmMonitorTimeout": 1,
  "bmStepTimeout": 1
}

Response

{
  "error": {
    "code": 1,
    "details": {
      "type": "constraintViolation"
    },
    "message": "string"
  }
}