Try it free

Get ActiveGate connection information

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Get the connection information an ActiveGate needs to connect to your Dynatrace environment with the Fleet Management API, for example during setup.

GETSaaShttps://{your-environment-id}.apps.dynatrace.com/v1/activegate/connection-info

Overview

You use this operation to retrieve the connection information for ActiveGates in your environment. It takes no parameters and returns the connection details with a 200 response. Typical usage is configuring a new ActiveGate, for example in an automated deployment that sets up the connection without manual steps.

Authentication

To execute this request, you need a platform token or OAuth access token with fleet-management:activegate.connection-info:read scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

The request doesn't provide any configurable parameters.

Response

Response codes

CodeTypeDescription
200ConnectionInfo

Success

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Response body objects

The ConnectionInfo object

Connection info with tenant data and initial tenant endpoint

ElementTypeDescription
initialEndpointstring

Initial tenant endpoint.

tenantTokenstring

Tenant token.

tenantUUIDstring

Tenant UUID.

The ErrorEnvelope object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
codeinteger

The HTTP status code

constraintViolationsConstraintViolation[]

A list of constraint violations

messagestring

The error message

The ConstraintViolation object

A list of constraint violations

ElementTypeDescription
locationstring-
messagestring-
parameterLocationstring-
The element can hold these values
  • HEADER
  • PATH
  • PAYLOAD_BODY
  • QUERY
pathstring-

Response body JSON models

{
"initialEndpoint": "string",
"tenantToken": "string",
"tenantUUID": "string"
}
{
"error": {
"code": 1,
"constraintViolations": [
{
"location": "string",
"message": "string",
"parameterLocation": "HEADER",
"path": "string"
}
],
"message": "string"
}
}
Related tags
Platform APIDynatrace Platform