Datadog Teams API
View and manage teams within Datadog. See the [Teams page](https://docs.datadoghq.com/account_management/teams/) for more information.
Datadog Teams API is one of 290 APIs that Datadog publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
This API exposes 4 JSON Schema definitions.
Tagged areas include Team. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, an API reference, and 4 JSON Schemas.
This API exposes 24 operations across 12 paths, and defines 143 schemas. It is described by OpenAPI 3.0.0, at version 1.0.
Requests are made against 3 base URLs: https://{subdomain}.{site}, {protocol}://{name}, https://{subdomain}.{site}.
24 operations
12 paths
143 schemas
4 DELETE10 GET4 PATCH4 POST2 PUT
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 4
Datadog Teams API declares
4 security schemes
for authenticating requests.
It supports OAuth 2.0 (AuthZ) using the authorizationCode flow, exposing 68 scopes.
An API key is passed in the header as DD-API-KEY (apiKeyAuth).
An API key is passed in the header as DD-APPLICATION-KEY (appKeyAuth).
It accepts HTTP bearer tokens (bearerAuth).
By default, every request must be authenticated.
AuthZ— This API uses OAuth 2 with the implicit grant flow.apiKeyAuth— Your Datadog API Key.appKeyAuth— Your Datadog APP Key.
Paths & Operations 24
Across 12 paths, the API surfaces 24 operations — 4 DELETE, 10 GET, 4 PATCH, 4 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.
Teams 24
View and manage teams within Datadog. See the [Teams page](https://docs.datadoghq.com/accountmanagement/teams/) for more information.
GET
/api/v2/on-call/teams/{team_id}/on-call
Datadog Get Team On-call Users
GET
/api/v2/on-call/teams/{team_id}/routing-rules
Datadog Get On-call Team Routing Rules
PUT
/api/v2/on-call/teams/{team_id}/routing-rules
Datadog Set On-call Team Routing Rules
GET
/api/v2/team
Datadog Get All Teams
POST
/api/v2/team
Datadog Create a Team
DELETE
/api/v2/team/{team_id}
Datadog Remove a Team
GET
/api/v2/team/{team_id}
Datadog Get a Team
PATCH
/api/v2/team/{team_id}
Datadog Update a Team
GET
/api/v2/team/{team_id}/links
Datadog Get Links for a Team
POST
/api/v2/team/{team_id}/links
Datadog Create a Team Link
DELETE
/api/v2/team/{team_id}/links/{link_id}
Datadog Remove a Team Link
GET
/api/v2/team/{team_id}/links/{link_id}
Datadog Get a Team Link
PATCH
/api/v2/team/{team_id}/links/{link_id}
Datadog Update a Team Link
GET
/api/v2/team/{team_id}/memberships
Datadog Get Team Memberships
POST
/api/v2/team/{team_id}/memberships
Datadog Add a User to a Team
DELETE
/api/v2/team/{team_id}/memberships/{user_id}
Datadog Remove a User from a Team
PATCH
/api/v2/team/{team_id}/memberships/{user_id}
Datadog Update a User's Membership Attributes on a Team
GET
/api/v2/team/{team_id}/permission-settings
Datadog Get Permission Settings for a Team
PUT
/api/v2/team/{team_id}/permission-settings/{action}
Datadog Update Permission Setting for Team
GET
/api/v2/teamsdeprecated
Datadog Get a List of All Incident Teams
POST
/api/v2/teamsdeprecated
Datadog Create a New Incident Team
DELETE
/api/v2/teams/{team_id}deprecated
Datadog Delete an Existing Incident Team
GET
/api/v2/teams/{team_id}deprecated
Datadog Get Details of an Incident Team
PATCH
/api/v2/teams/{team_id}deprecated
Datadog Update an Existing Incident Team
Schemas 143
The contract defines 143 schemas that model the data the API accepts and returns. The most detailed are TeamAttributes (12 properties), UserAttributes (12 properties), TeamsResponseMetaPagination (8 properties), TeamCreateAttributes (7 properties). Each schema is shown below with its type and property counts.
UserTeamUpdate
object
A user's relationship with a team
2 properties
1 required
SendTeamsMessageActionType
string
Indicates that the action is a send Microsoft Teams message action.
UsersType
string
Users resource type.
UserTeamRelationships
object
Relationship between membership and a user
2 properties
RoutingRule
object
Represents a routing rule, including its attributes, relationships, and unique identifier.
4 properties
1 required
TeamOnCallRespondersDataRelationships
object
Relationship objects linked to a team's on-call responder configuration, including escalations and responders.
2 properties
TeamLinkAttributes
object
Team link attributes
4 properties
2 required
RelationshipToUserTeamPermission
object
Relationship between a user team permission and a team
2 properties
UserAttributes
object
Attributes of user object returned by the API.
12 properties
TeamLinkCreateRequest
object
Team link create request
1 property
1 required
TeamLink
object
Team link
3 properties
3 required
IncidentTeamUpdateAttributes
object
The incident team's attributes for an update request.
1 property
1 required
RelationshipToTeamLinks
object
Relationship between a team and a team link
2 properties
TeamLinksResponse
object
Team links response
1 property
TeamPermissionSettingSerializerAction
string
The identifier for the action
User
object
User object returned by the API.
4 properties
TeamOnCallRespondersDataRelationshipsRespondersDataItems
object
Represents a user responder associated with the on-call team.
2 properties
2 required
TeamsResponseMeta
object
Teams response metadata.
1 property
TeamRoutingRulesData
object
Represents the top-level data object for team routing rules, containing the ID, relationships, and resource type.
3 properties
1 required
TeamRoutingRulesDataType
string
Team routing rules resource type.
RelationshipToUser
object
Relationship to user.
1 property
1 required
UserTeamPermissionType
string
User team permission type
UserTeamRole
string
The user's role within the team
EscalationRelationships
object
Contains the relationships of an escalation object, including its responders.
1 property
TeamCreate
object
Team create
3 properties
2 required
TeamOnCallRespondersDataRelationshipsResponders
object
Defines the list of users assigned as on-call responders for the team.
1 property
RelationshipToOrganization
object
Relationship to an organization.
1 property
1 required
TeamLinkResponse
object
Team link response
1 property
IncidentTeamCreateRequest
object
Create request with an incident team payload.
1 property
1 required
IncidentTeamResponseAttributes
object
The incident team's attributes from a response.
3 properties
TeamRelationships
object
Resources related to a team
2 properties
RoutingRuleAttributes
object
Defines the configurable attributes of a routing rule, such as actions, query, time restriction, and urgency.
4 properties
RelationshipToUserData
object
Relationship to user object.
2 properties
2 required
TeamUpdateRequest
object
Team update request
1 property
1 required
TeamRoutingRules
object
Represents a complete set of team routing rules, including data and optionally included related resources.
2 properties
TimeRestriction
object
Defines a single time restriction rule with start and end times and the applicable weekdays.
4 properties
IncidentResponseMetaPagination
object
Pagination properties.
3 properties
TeamRoutingRulesRequestDataAttributes
object
Represents the attributes of a request to update or create team routing rules.
1 property
TeamPermissionSettingValues
array
Possible values for action
EscalationRelationshipsRespondersDataItemsType
string
Represents the resource type for users assigned as responders in an escalation step.
TeamLinkCreate
object
Team link create
2 properties
2 required
TeamUpdateAttributes
object
Team update attributes
7 properties
2 required
TeamPermissionSettingUpdateAttributes
object
Team permission setting update attributes
1 property
TeamUpdateRelationships
object
Team update relationships
1 property
RelationshipToUserTeamTeamData
object
The team associated with the membership
2 properties
2 required
IncidentTeamIncludedItems
An object related to an incident team which is present in the included payload.
SendSlackMessageActionType
string
Indicates that the action is a send Slack message action.
TeamCreateRequest
object
Request to create a team
1 property
1 required
TeamPermissionSetting
object
Team permission setting
3 properties
2 required
IncidentResponseMeta
object
The metadata object containing pagination metadata.
1 property
RoutingRuleRelationships
object
Specifies relationships for a routing rule, linking to associated policy resources.
1 property
ListTeamsInclude
string
Included related resources optionally requested.
TeamCreateAttributes
object
Team creation attributes
7 properties
2 required
UserTeamType
string
Team membership type
TimeRestrictions
object
Holds time zone information and a list of time restrictions for a routing rule.
2 properties
2 required
TeamOnCallRespondersDataRelationshipsEscalationsDataItemsType
string
Identifies the resource type for escalation policy steps linked to a team's on-call configuration.
TeamsField
string
Supported teams field.
TeamType
string
Team type
EscalationRelationshipsRespondersDataItems
object
Represents a user assigned to an escalation step.
2 properties
2 required
UserTeamRequest
object
Team membership request
1 property
1 required
TeamRoutingRulesDataRelationshipsRulesDataItemsType
string
Indicates that the resource is of type 'teamroutingrules'.
IncidentTeamsResponse
object
Response with a list of incident team payloads.
3 properties
1 required
TeamOnCallResponders
object
Root object representing a team's on-call responder configuration.
2 properties
OrganizationsType
string
Organizations resource type.
UserTeamAttributes
object
Team membership attributes
3 properties
TeamPermissionSettingValue
string
What type of user is allowed to perform the specified action
RoutingRuleAction
Defines an action that is executed when a routing rule matches certain criteria.
TeamOnCallRespondersDataRelationshipsEscalationsDataItems
object
Represents a link to a specific escalation policy step associated with the on-call team.
2 properties
2 required
UserTeamPermission
object
A user's permissions for a given team
3 properties
2 required
TeamsResponseLinks
object
Teams response links.
5 properties
UserTeam
object
A user's relationship with a team
4 properties
2 required
RelationshipToUserTeamPermissionData
object
Related user team permission data
2 properties
2 required
TeamUpdate
object
Team update request
3 properties
2 required
TeamPermissionSettingType
string
Team permission setting type
Weekday
string
A day of the week.
TeamRoutingRulesDataRelationshipsRulesDataItems
object
Defines a relationship item to link a routing rule by its ID and type.
2 properties
2 required
TeamRoutingRulesRequestData
object
Holds the data necessary to create or update team routing rules, including attributes, ID, and resource type.
3 properties
1 required
APIErrorResponse
object
API error response.
1 property
1 required
TeamCreateRelationships
object
Relationships formed with the team on creation
1 property
UserResponseRelationships
object
Relationships of the user object returned by the API.
4 properties
TeamOnCallRespondersDataRelationshipsRespondersDataItemsType
string
Identifies the resource type for individual user entities associated with on-call response.
RelationshipToUserTeamTeam
object
Relationship between team membership and team
1 property
1 required
UserTeamResponse
object
Team membership response
2 properties
IncidentTeamUpdateRequest
object
Update request with an incident team payload.
1 property
1 required
RoutingRuleRelationshipsPolicyData
object
Represents the policy data reference, containing the policy's ID and resource type.
2 properties
2 required
TeamResponse
object
Response with a team
1 property
IncidentTeamResponse
object
Response with an incident team payload.
2 properties
1 required
TeamPermissionSettingResponse
object
Team permission setting response
1 property
UserTeamPermissionAttributes
object
User team permission attributes
1 property
IncidentTeamUpdateData
object
Incident Team data for an update request.
4 properties
1 required
TeamPermissionSettingUpdate
object
Team permission setting update
2 properties
1 required
TeamRoutingRulesDataRelationships
object
Specifies relationships for team routing rules, including rule references.
1 property
TeamOnCallRespondersData
object
Defines the main on-call responder object for a team, including relationships and metadata.
3 properties
1 required
RelationshipToRoleData
object
Relationship to role object.
2 properties
TeamRoutingRulesRequest
object
Represents a request to create or update team routing rules, including the data payload.
1 property
RelationshipToOrganizationData
object
Relationship to organization object.
2 properties
2 required
EscalationRelationshipsResponders
object
Lists the users involved in a specific step of the escalation policy.
1 property
TeamsResponseMetaPagination
object
Teams response metadata.
8 properties
Urgency
string
Specifies the level of urgency for a routing rule (low, high, or dynamic).
TeamOnCallRespondersDataRelationshipsEscalations
object
Defines the escalation policy steps linked to the team's on-call configuration.
1 property
TeamAttributes
object
Team attributes
12 properties
2 required
UserTeamTeamType
string
User team team type
IncidentTeamResponseData
object
Incident Team data from a response.
4 properties
RelationshipToTeamLinkData
object
Relationship between a link and a team
2 properties
2 required
TeamOnCallRespondersDataType
string
Represents the resource type for a group of users assigned to handle on-call duties within a team.
SendTeamsMessageAction
object
Sends a message to a Microsoft Teams channel.
4 properties
4 required
TeamsResponse
object
Response with multiple teams
4 properties
RelationshipToUsers
object
Relationship to users.
1 property
1 required
RelationshipToUserTeamUser
object
Relationship between team membership and user
1 property
1 required
EscalationType
string
Represents the resource type for individual steps in an escalation policy used during incident response.
TeamRoutingRulesRequestDataType
string
Team routing rules resource type.
RoutingRuleRelationshipsPolicyDataType
string
Indicates that the resource is of type 'policies'.
IncidentTeamCreateData
object
Incident Team data for a create request.
3 properties
1 required
GetTeamMembershipsSort
string
Specifies the order of returned team memberships
TeamLinkType
string
Team link type
RelationshipToRoles
object
Relationship to roles.
1 property
TeamRoutingRulesIncluded
Represents additional included resources for team routing rules, such as associated routing rules.
RelationshipToOrganizations
object
Relationship to organizations.
1 property
1 required
UserTeamUserType
string
User team user type
TeamPermissionSettingAttributes
object
Team permission setting attributes
5 properties
ListTeamsSort
string
Specifies the order of the returned teams
Team
object
A team
4 properties
3 required
TeamPermissionSettingsResponse
object
Team permission settings response
1 property
TeamOnCallRespondersIncluded
Represents an union of related resources included in the response, such as users and escalation steps.
IncidentTeamCreateAttributes
object
The incident team's attributes for a create request.
1 property
1 required
TeamRelationshipsLinks
object
Links attributes.
1 property
RoutingRuleRelationshipsPolicy
object
Defines the relationship that links a routing rule to a policy.
1 property
TeamPermissionSettingUpdateRequest
object
Team permission setting update request
1 property
1 required
TeamIncluded
Included resources related to the team
Escalation
object
Represents an escalation policy step.
3 properties
1 required
TeamRoutingRulesRequestRule
object
Defines an individual routing rule item that contains the rule data for the request.
5 properties
UserTeamIncluded
Included resources related to the team membership
RelationshipToUserTeamUserData
object
A user's relationship with a team
2 properties
2 required
RoutingRuleType
string
Team routing rules resource type.
UserTeamCreate
object
A user's relationship with a team
3 properties
1 required
UserTeamsResponse
object
Team memberships response
4 properties
TeamRoutingRulesDataRelationshipsRules
object
Holds references to a set of routing rules in a relationship.
1 property
UserTeamUpdateRequest
object
Team membership request
1 property
1 required
IncidentRelatedObject
string
Object related to an incident.
RolesType
string
Roles type.
IncidentTeamType
string
Incident Team resource type.
IncidentTeamRelationships
object
The incident team's relationships.
2 properties
SendSlackMessageAction
object
Sends a message to a Slack channel.
3 properties
3 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Datadog 12
Other APIs Datadog publishes across the network.
Datadog Dashboards API
Datadog Synthetics API
Datadog Service Level Objectives API
Datadog Security Monitoring API
Datadog Service Definition API
Datadog Software Catalog API
Datadog Users API
Datadog Roles API
Datadog Key Management API
Datadog Organizations API
Datadog Downtimes API
Datadog RUM API
#Team
Where this information came from
This is an independent, third-party profile of Datadog Teams API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.