Allowed beacon domains API - GET configuration

Gets the configuration of the allowed beacon origins for Cross Origin Resource Sharing (CORS) requests.

The request produces an application/json payload.

Early Adopter

This request is an Early Adopter release and may be changed in non-compatible way.

  • Managed https://{your-domain}/e/{your-environment-id}/api/config/v1/allowedBeaconOriginsForCors
  • SaaS https://{your-environment-id}


To execute this request, you need the Read configuration (ReadConfig) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.


The request doesn't provide any configurable parameters.

Response format

The AllowedBeaconOriginsDto object

Element Type Description
metadata ConfigurationMetadata
allowedBeaconOrigins BeaconDomainPattern[]

A list of allowed beacon origins for CORS requests.

rejectBeaconsWithoutOriginHeader boolean

If set to true, beacons without an HTTP Header 'Origin' will be discarded on the BeaconForwarder. Defaults to false.

The BeaconDomainPattern object

Allowed beacon domain pattern for CORS requests

Element Type Description
domainNameMatcher string

Enum for the domain matcher

The domainNameMatcher element can hold these values.
domainNamePattern string

Pattern of the domain name

The ConfigurationMetadata object

Metadata useful for debugging

Element Type Description
configurationVersions integer[]

A Sorted list of the version numbers of the configuration.

currentConfigurationVersions string[]

A Sorted list of string version numbers of the configuration.

clusterVersion string

Dynatrace server version.

Possible values

Possible values for the domainNameMatcher element in the BeaconDomainPattern object: