v1

latestOpenAPI 3.0.22026-07-144652931.4 MB
Teams

Delete a 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

Scoped OAuth requires: teams.write

delete/teams/{id}

Path parameters

idstring required

The ID of the resource.

Query parameters

reassignment_teamstring

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

Headers

Acceptstring required

The Accept header is used as a versioning header.

Content-Type'application/json' required

Response

The team was deleted successfully.