Try it free

Get matching EdgeConnects for a URL

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Get the matching EdgeConnect for a URL in Dynatrace with the EdgeConnect API, plus alternative EdgeConnects with more general host patterns.

GETSaaShttps://{your-environment-id}.apps.dynatrace.com/v1/edge-connects:match

Overview

You provide the url query parameter to check which EdgeConnect matches that URL and which alternatives also match. The response returns the matched EdgeConnect and considered alternatives that are more general.

Authentication

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

Parameters

ParameterTypeDescriptionInRequired
urlstring

The URL which is used to check if there are any EdgeConnects with matching host patterns configured. Must be RFC 2396 compliant and use "http" or "https" as its scheme

queryRequired

Response

Response codes

CodeTypeDescription
200MatchedResponse

The matched EdgeConnect and considered alternatives which are more general

400ErrorResponse

Bad Request

default--

Response body objects

The MatchedResponse object

ElementTypeDescription
matchedMatchedEdgeConnect

Contains information about the EdgeConnect and the matched pattern

secondaryMatchingMatchedEdgeConnect[]-

The MatchedEdgeConnect object

Contains information about the EdgeConnect and the matched pattern

ElementTypeDescription
idstring-
nameEdgeConnectName-
matchedPatternstring-
metadataMetadata-

The EdgeConnectName object

The Metadata object

ElementTypeDescription
instancesEdgeConnectInstance[]-
oauthClientStatusstring

The status of the OAuth client

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

The EdgeConnectInstance object

ElementTypeDescription
versionstring-
instanceIdstring-

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

{
"matched": {
"id": "11111111-2222-4444-3333-555555555555",
"name": "internal-services",
"matchedPattern": "string",
"metadata": {
"instances": [
{
"version": "1.46.2",
"instanceId": "string"
}
],
"oauthClientStatus": "ACTIVE"
}
},
"secondaryMatching": [
{}
]
}
Related tags
Platform APIDynatrace Platform