Settings API - Ownership teams schema table

Ownership teams (builtin:ownership.teams)

Set up teams and assign responsibilities to them. Link teams to monitored entities in Dynatrace by referencing the team identifier in entity metadata. See documentation

Schema IDSchema groupsScope
builtin:ownership.teams
  • group:ownership
environment
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:ownership.teams
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:ownership.teams
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:ownership.teams

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
Team name
name		text-required
Description
description		text-optional
Team identifier
identifier		text

The team identifier is used to reference the team from any entity in Dynatrace. If you are using Kubernetes labels, keep in mind the 63 character limit that they enforce.

required
Supplementary identifiers
supplementaryIdentifiers		Set<SupplementaryIdentifier>

The supplementary team identifiers can be optionally used in addition to the main team identifier to reference this team from any entity in Dynatrace. Up to 3 supplementary identifiers are supported.

required
Responsibilities
responsibilities		Responsibilities

Turn on all responsibility assignments that apply to this team.

required
Contact details
contactDetails		ContactDetails[]

Define options for messaging integration or other means of contacting this team.

required
Links
links		Link[]

Include links to online resources where information relevant to this team’s responsibilities can be found.

required
Additional information
additionalInformation		AdditionalInformation[]

Define key/value pairs that further describe this team — for example, cost center, solution type, or business unit assignments.

required
External ID
externalId		text

This field should only be used for the automation purpose when importing team information.

optional
The SupplementaryIdentifier object
PropertyTypeDescriptionRequired
Supplementary Identifier
supplementaryIdentifier		text-required
The Responsibilities object
PropertyTypeDescriptionRequired
Development
development		boolean

Responsible for developing and maintaining high quality software. Development teams are responsible for making code changes to address performance regressions, errors, or security vulnerabilities.

required
Security
security		boolean

Responsible for the security posture of the organization. Teams with security responsibility must understand the impact, priority, and team responsible for addressing security vulnerabilities.

required
Operations
operations		boolean

Responsible for deploying and managing software, with a focus on high availability and performance. Teams with operations responsibilities needs to understand the impact, priority, and team responsible for addressing problems detected by Dynatrace.

required
Infrastructure
infrastructure		boolean

Responsible for the administration, management, and support of the IT infrastructure including physical servers, virtualization, and cloud. Teams with infrastructure responsibility are responsible for addressing hardware issues, resource limits, and operating system vulnerabilities.

required
Line of Business
lineOfBusiness		boolean

Responsible for ensuring that applications in development align with business needs and meet the usability requirements of users, stakeholders, customers, and external partners. Teams with line of business responsibility are responsible for understanding the customer experience and how it affects business goals.

required
The ContactDetails object
PropertyTypeDescriptionRequired
Integration type
integrationType		enum
  • JIRA
  • EMAIL
  • MS_TEAMS
  • SLACK
required
Email
email		text-required
Team
msTeams		text-required
Jira
jira		JiraConnection-required
Channel
slackChannel		text-required
URL
url		text-optional
The AdditionalInformation object
PropertyTypeDescriptionRequired
Name
key		text-required
Value
value		text-required
URL
url		text-optional
The JiraConnection object
PropertyTypeDescriptionRequired
Project
project		text-required
Default Assignee
defaultAssignee		text-required