Try it free

Update public location status

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

Update public synthetic location status in Dynatrace with the Synthetic API by setting whether public locations are enabled.

PUTSaaShttps://{your-environment-id}.apps.dynatrace.com/platform/synthetic/v1/locations/status

Overview

You use the locations status endpoint to change the status of public synthetic locations. The request body includes enabled, 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:locations:write scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
bodySyntheticPublicLocationsStatusDto

The new status of public synthetic locations.

bodyRequired

Request body objects

The SyntheticPublicLocationsStatusDto object

The status of public synthetic locations.

ElementTypeDescriptionRequired
enabledboolean

Synthetic monitors can (true) or can't (false) run on public synthetic locations.

Required

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

{
"enabled": true
}

Response

Response codes

CodeTypeDescription
204-

Success. Locations status has been updated.

409-

Conflict. Public locations couldn't be disabled because there are monitors assigned to them.

4XXErrorResponseEnvelope

Client side error.

5XXErrorResponseEnvelope

Server side error.

Response body objects

The ErrorResponseEnvelope object

Encloses the encountered error.

ElementTypeDescription
errorErrorResponse

Basic information of the encountered error.

The ErrorResponse object

Basic information of the encountered error.

ElementTypeDescription
codeinteger

The returned HTTP status code.

detailsErrorResponseDetails

Detailed information of the error.

messagestring

Description of the encountered error.

The ErrorResponseDetails object

Detailed information of the error.

ElementTypeDescription
typestring

Defines the actual set of fields depending on the value. See one of the following objects:

  • constraintViolation -> ConstraintViolationDetails
The element can hold these values
  • constraintViolation

Response body JSON models

{
"error": {
"code": 1,
"details": {
"type": "constraintViolation"
},
"message": "string"
}
}
Related tags
Platform APIDynatrace PlatformDigital Experience