Auto update problems - GET all auto update problems on a host

  • Reference
  • Published Oct 03, 2025

List all cluster-side detected auto-update problems that may block further rollout of a OneAgent version on a particular host.

The request produces an application/json payload.

GETSaaShttps://{your-environment-id}.live.dynatrace.com/api/v1/oneagents/autoUpdateProblems
GETEnvironment ActiveGatehttps://{your-activegate-domain}:9999/e/{your-environment-id}/api/v1/oneagents/autoUpdateProblems

Authentication

To execute this request, you need an access token with oneAgents.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
200AgentPotentialProblemsState

Success

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Response body objects

The AgentPotentialProblemsState object

All agent potential auto-update problems aggregated over all servers for this tenant.

ElementTypeDescription
autoUpdateProblemsAgentPotentialProblem[]

List of all agent auto-update blocking problems

The AgentPotentialProblem object

One agent auto-update blocking problem for a specific version and OS, with a list of affected hosts.

ElementTypeDescription
architecturestring

Installer Architecture

The element can hold these values
  • OS_ARCHITECTURE_ARM
  • OS_ARCHITECTURE_IA64
  • OS_ARCHITECTURE_PARISC
  • OS_ARCHITECTURE_PPC
  • OS_ARCHITECTURE_PPCLE
  • OS_ARCHITECTURE_S390
  • OS_ARCHITECTURE_SPARC
  • OS_ARCHITECTURE_UNKNOWN
  • OS_ARCHITECTURE_X86
  • OS_ARCHITECTURE_ZOS
hostsstring[]

All hosts that are affected by the auto-update problem, given by ME Identifier

osTypestring

Installer OS type

The element can hold these values
  • AIX
  • DARWIN
  • HPUX
  • LINUX
  • SOLARIS
  • WINDOWS
  • ZOS
versionstring

Formatted Installer version

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

{
  "autoUpdateProblems": [
    {
      "architecture": "OS_ARCHITECTURE_ARM",
      "hosts": [
        "string"
      ],
      "osType": "AIX",
      "version": "string"
    }
  ]
}
{
  "error": {
    "code": 1,
    "constraintViolations": [
      {
        "location": "string",
        "message": "string",
        "parameterLocation": "HEADER",
        "path": "string"
      }
    ],
    "message": "string"
  }
}