Try it free

Settings API - OTLP Connector connections schema table

  • Published Nov 09, 2026

OTLP Connector connections (builtin:otlp-connector.connections.otlp)

Connection configurations for the OTLP Connector app (dynatrace.otlp.connector)

Schema IDSchema groupsScope
builtin:otlp-connector.connections.otlp-
environment
Retrieve schema via Settings API
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:otlp-connector.connections.otlp
GETSaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:otlp-connector.connections.otlp
GETEnvironment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:otlp-connector.connections.otlp

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

PropertyTypeDescriptionRequired
Name
name		text

Unique name for this connection

Required
Protocol
protocol		enum

Protocol used for the OTLP connection

The element has these enums
  • http
  • grpc
Required
Endpoint
endpoint		text

Full endpoint URL, e.g. https://collector.example.com:4318

Required
Authentication type
authType		enum

Authentication mechanism for the connection

The element has these enums
  • none
Required
Consumers
consumers		Consumers[]

Dynatrace integrations that will receive data from this connection

The element has these enums
  • SVC:com.dynatrace.openpipeline
Required
Enable TLS
tlsEnabled		boolean

Enable TLS for the connection. Independent of the chosen authentication type.

Required
Enable mTLS
mTlsEnabled		boolean

Enable mutual TLS authentication. When enabled, the client presents its own certificate to the server.

Required
CA certificate
caCertificate		text

PEM-encoded CA certificate used to verify the server. Required when the server uses a private CA. Leaf and intermediate certificates may be concatenated.

Optional
Client certificate
clientCertificate		text

PEM-encoded client certificate (leaf + optional intermediates) presented during mutual authentication

Optional
Client private key
clientPrivateKey		secret

PEM-encoded private key corresponding to the client certificate

Optional
Client private key password
clientPrivateKeyPassword		secret

Passphrase for the client private key. Leave empty for unencrypted keys.

Optional