Skip to main content

Delete Team

Remove 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.

External Documentation

To learn more, visit the PagerDuty documentation.

Parameters

ParameterDescription
Reassignment TeamTeam to reassign unresolved incident to.
If an unresolved incident exists on both the reassignment team and
the team being deleted, a duplicate will not be made. If not supplied,
unresolved incidents will be made account-level.
Team IDThe ID of the team to delete.

Workflow Library Example

Delete Team with Pagerduty and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop