Third-party synthetic API - POST modify state of third-party monitors

Modifies the operation state of all third-party monitors.

The request consumes an application/json payload.

POST
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/synthetic/ext/stateModifications
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/synthetic/ext/stateModifications

Authentication

To execute this request, you need the Create and read synthetic monitors, locations, and nodes (ExternalSyntheticIntegration) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter Type Description In Required
body StateModification

The JSON body of the request. Contains new operational status of third-party synthetic monitors.

body optional

Body format

The StateModification object

Operation state to be set for all third-party Synthetic monitors

Element Type Description Required
state string

The new operation state for all third-party Synthetic monitors.

required

Response

Response codes

Code Description
204

Success. The state of third-party monitors has been changed.

400

Failed. The input is invalid.

Response body

A successful request doesn't return any content.

Example

In this example, the request sets the state of third-party monitors to active.

The API token is passed in the Authorization header.

Curl

curl -X POST \
  https://mySampleEnv.live.dynatrace.com/api/v1/synthetic/ext/stateModifications \
  -H 'Authorization: Api-Token abcdefjhij1234567890' \
  -H 'Content-Type: application/json' \
  -d '{
  "state": "ACTIVE"
}
'

Request URL

https://mySampleEnv.live.dynatrace.com/api/v1/synthetic/ext/stateModifications

Request body

{
  "state": "ACTIVE"
}

Response code

204