Try it free

Update an EdgeConnect

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Update an EdgeConnect configuration in Dynatrace with the EdgeConnect API by ID, including host patterns, mappings, OAuth client data, and metadata.

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

Overview

You provide the edgeConnectId path parameter and an EdgeConnect request body with fields such as id, name, hostPatterns, hostMappings, and OAuth client settings. The response confirms the EdgeConnect has been updated successfully.

Authentication

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

Parameters

ParameterTypeDescriptionInRequired
edgeConnectIdstring

Specify the ID of the EdgeConnect

pathRequired
bodyEdgeConnect

Maps the specified host patterns to this EdgeConnect

bodyRequired

Request body objects

The EdgeConnect object

Maps the specified host patterns to this EdgeConnect

ElementTypeDescriptionRequired
idstring-Optional
nameEdgeConnectName-Required
hostPatternsHostPattern[]-Required
hostMappingsHostMapping[]-Optional
oauthClientIdstring

Id of OAuth client used to connect by the EdgeConnect

Optional
oauthClientSecretstring

Secret of OAuth client used to connect by the EdgeConnect. Only provided when creating a new EdgeConnect.

Optional
oauthClientResourcestring

Resource of OAuth client used to connect by the EdgeConnect. Only provided when creating a new EdgeConnect.

Optional
modificationInfoModificationInfo-Optional
metadataMetadata-Optional
managedByDynatraceOperatorboolean

Flag to identify if an EdgeConnect is managed by the Dynatrace operator. False by default!

Optional

The EdgeConnectName object

The HostPattern object

Either an IP, or a domain name which may contain a wildcard ('') as the leftmost label. If a '' is used, it must be followed by at least two labels.

The HostMapping object

Todo

ElementTypeDescriptionRequired
fromstring-Required
tostring-Required

The ModificationInfo object

ElementTypeDescriptionRequired
lastModifiedBystring-Required
lastModifiedTimestring-Required

The Metadata object

ElementTypeDescriptionRequired
instancesEdgeConnectInstance[]-Optional
oauthClientStatusstring

The status of the OAuth client

The element can hold these values
  • ACTIVE
  • INACTIVE
  • PENDING_DELETION
  • DELETED
Optional

The EdgeConnectInstance object

ElementTypeDescriptionRequired
versionstring-Optional
instanceIdstring-Optional

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.

{
  "id": "11111111-2222-4444-3333-555555555555",
  "name": "internal-services",
  "hostPatterns": [
    "*.internal.org"
  ],
  "hostMappings": [
    {
      "from": "test.local",
      "to": "kubernetes.my.cluster.local"
    }
  ],
  "oauthClientId": "dt0s02.AIOUP56P",
  "oauthClientSecret": "dt0s02.AIOUP56P.5ODBJEQYBA4KLD2F6F6EHQZKYK5Q45RARKVCHICXKLMAXVVLIH2L6N5RLMDDY4QA",
  "oauthClientResource": "urn:dtenvironment:wu31a2p3",
  "modificationInfo": {
    "lastModifiedBy": "12345678-abcd-efgh-1234-123456789",
    "lastModifiedTime": "2022-01-01T01:02:03.165Z"
  },
  "metadata": {
    "instances": [
      {
        "version": "1.46.2",
        "instanceId": "string"
      }
    ],
    "oauthClientStatus": "ACTIVE"
  },
  "managedByDynatraceOperator": false
}

Response

Response codes

CodeTypeDescription
200-

The EdgeConnect has been update successfully

400ErrorResponse

Bad Request

default--

Response body objects

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

{
  "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