Try it free

Rotate an EdgeConnect OAuth client secret

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Rotate the autogenerated OAuth client secret for an EdgeConnect in Dynatrace with the EdgeConnect API when the client was created automatically.

POSTSaaShttps://{your-environment-id}.apps.dynatrace.com/v1/edge-connects/{edgeConnectId}/oauthClient:rotate

Overview

You provide the edgeConnectId path parameter to rotate the secret for the EdgeConnect's autogenerated OAuth client. The response confirms the OAuth client secret was rotated successfully.

Authentication

To execute this request, you need a platform token or OAuth access token with oauth2:clients:manage scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
edgeConnectIdstring

Specify the ID of the EdgeConnect

pathRequired

Response

Response codes

CodeTypeDescription
200OAuthClientRotationResponse

The OAuth client secret was rotated successfully

400ErrorResponse

The configured OAuth client isn't supported to be rotated. (i.e. it wasn't autogenerated upon EdgeConnect creation)

default--

Response body objects

The OAuthClientRotationResponse object

ElementTypeDescription
clientSecretstring-
clientIdstring-

The ErrorResponse object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
codeinteger-
messagestring-
detailsErrorDetails-

The ErrorDetails object

ElementTypeDescription
constraintViolationsConstraintViolation[]-
missingScopesstring[]-
missingPermissionsstring[]-

The ConstraintViolation object

ElementTypeDescription
messagestring-
pathstring-
parameterLocationstring-

Response body JSON models

{
  "clientSecret": "string",
  "clientId": "string"
}
{
  "error": {
    "code": 1,
    "message": "string",
    "details": {
      "constraintViolations": [
        {
          "error": {
            "code": 400,
            "message": "Constraints violated. Properties already exist in another configuration.",
            "details": {
              "constraintViolations": [
                {
                  "path": "hostPatterns[0]",
                  "message": "Host pattern must be unique across configurations.\nHost pattern 'myjira.com' already exists in EdgeConnect configuration 'InternalServices'."
                }
              ]
            }
          }
        }
      ],
      "missingScopes": [
        "string"
      ],
      "missingPermissions": [
        "string"
      ]
    }
  }
}
Related tags
Platform APIDynatrace Platform