Try it free

Settings API - Cloud SRE Agents schema table

  • Published Jun 15, 2026

Cloud SRE Agents (app:community.cloudsreagents:cloudsreagent-agent)

Configure cloud SRE agents for automated investigation and remediation

Schema IDSchema groupsScope
app:community.cloudsreagents:cloudsreagent-agent-
environment
Retrieve schema via Settings API
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/app:community.cloudsreagents:cloudsreagent-agent
GETSaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/app:community.cloudsreagents:cloudsreagent-agent
GETEnvironment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/app:community.cloudsreagents:cloudsreagent-agent

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
Agent name
name		text

A unique name for this agent configuration

Required
Description
description		text

A description of this agent configuration

Optional
Agent type
type		enum

The type of cloud agent

The element has these enums
  • aws
  • azure
  • gcp
Required
Enabled
enabled		boolean

Whether this agent is enabled

Required
Endpoint URL
endpoint		text

The API endpoint URL for the agent

Required
Credential
credential		secret

The credential used to authenticate with the agent

Optional
Store raw messages
storeRawMessages		boolean

When enabled, raw agent messages will be stored for debugging purposes

Required
Monthly Duration Budget (minutes)
durationBudgetMinutes		integer

Maximum total investigation/mitigation duration allowed per calendar month. Leave empty for unlimited.

Optional
Strict Budget Enforcement
strictBudget		boolean

When enabled, the budget filter blocks dispatch if exceeded. When disabled, proceeds with a warning event.

Required