Skip to main content

teams

Overview

Nameteams
TypeResource
Idpagerduty.teams.teams

Fields

NameDatatypeDescription
idstring
namestringThe name of the team.
descriptionstringThe description of the team.
_typestringThe type of object being created.
html_urlstringa URL at which the entity is uniquely displayed in the Web app
parentobject
selfstringthe API show URL at which the object is accessible
summarystringA short-form, server-generated string that provides succinct, important information about an object suitable for primary labeling of an entity in a client. In many cases, this will be identical to name, though it is not intended to be an identifier.
typestringA string that determines the schema of the object. This must be the standard name for the entity, suffixed by _reference if the object is a reference.

Methods

NameAccessible byRequired ParamsDescription
get_teamSELECTidGet details about an existing team.

A team is a collection of Users and Escalation Policies that represent a group of people within an organization.

For more information see the API Concepts Document

Scoped OAuth requires: teams.read
list_teamsSELECTList teams of your PagerDuty account, optionally filtered by a search query.

A team is a collection of Users and Escalation Policies that represent a group of people within an organization.

For more information see the API Concepts Document

Scoped OAuth requires: teams.read
create_teamINSERTdata__teamCreate a new Team.

A team is a collection of Users and Escalation Policies that represent a group of people within an organization.

For more information see the API Concepts Document

Scoped OAuth requires: teams.write
delete_teamDELETEidRemove an existing team.

Succeeds only if the team has no associated Escalation Policies, Services, Schedules and Subteams.

All associated unresovled incidents will be reassigned to another team (if specified) or will loose team association, thus becoming account-level (with visibility implications).

Note that the incidents reassignment process is asynchronous and has no guarantee to complete before the API call return.

A team is a collection of Users and Escalation Policies that represent a group of people within an organization.

For more information see the API Concepts Document

Scoped OAuth requires: teams.write
_get_teamEXECidGet details about an existing team.

A team is a collection of Users and Escalation Policies that represent a group of people within an organization.

For more information see the API Concepts Document

Scoped OAuth requires: teams.read
_list_teamsEXECList teams of your PagerDuty account, optionally filtered by a search query.

A team is a collection of Users and Escalation Policies that represent a group of people within an organization.

For more information see the API Concepts Document

Scoped OAuth requires: teams.read
update_teamEXECid, data__teamUpdate an existing team.

A team is a collection of Users and Escalation Policies that represent a group of people within an organization.

For more information see the API Concepts Document

Scoped OAuth requires: teams.write