Try it free

Settings API - Cloud SRE Interaction Profiles schema table

  • Published Jun 15, 2026

Cloud SRE Interaction Profiles (app:community.cloudsreagents:cloudsreagent-interactionprofile)

Configure interaction profiles to route problems to cloud agents based on filters

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

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

A unique name for this interaction profile

Required
Description
description		text

A description of this interaction profile

Optional
Enabled
enabled		boolean

Whether this interaction profile is enabled

Required
Deferred
deferred		integer

Delay execution by this many minutes (0-15). Set to 0 or leave empty for immediate execution.

Optional
Global Filter Expression
globalFilterExpression		text

JSON filter expression with AND/OR logic for global filters.

Example: {"logic":"and","filters":[{"type":"matches_problem_severity","values":["ERROR"]},{"logic":"or","filters":[...]}]}

Optional
Agent References
agentRefs		AgentRef[]

References to agents with their specific filters

Required
Topology Max Depth
topologyMaxDepth		integer

Maximum depth for topology traversal when discovering related cloud resources (defaults to 3 if not set)

Optional
The AgentRef object
PropertyTypeDescriptionRequired
Agent ID
agentId		text

The ID of the agent to reference

Required
Enabled
enabled		boolean

Override agent enabled state for this profile

Required
Filter Expression
filterExpression		text

JSON filter expression with AND/OR logic. Supports nested groups.

Example: {"logic":"and","filters":[{"type":"has_aws_resources","expected":true},{"logic":"or","filters":[...]}]}

Optional