Delete a team - Rootly

DELETE

teams

{id}

curl --request DELETE \
  --url https://api.rootly.com/v1/teams/{id} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "id": "da788f78-edd9-4ed4-9c0f-1257e7495989",
    "type": "groups",
    "attributes": {
      "slug": "sapiente-error-harum-quia",
      "name": "Sapiente error harum quia.",
      "description": null,
      "color": "#D7F5E1",
      "position": 1,
      "notify_emails": [],
      "slack_channels": [],
      "slack_aliases": [],
      "pagerduty_id": null,
      "pagerduty_service_id": null,
      "backstage_id": null,
      "external_id": null,
      "opsgenie_id": null,
      "victor_ops_id": null,
      "pagertree_id": null,
      "cortex_id": null,
      "service_now_ci_sys_id": null,
      "user_ids": [],
      "admin_ids": [],
      "incidents_count": 1,
      "alert_urgency_id": null,
      "alerts_email_enabled": false,
      "alerts_email_address": "group-72ef3dd12b6728e442e9ae739c3db375@email.rootly.com",
      "created_at": "2025-03-19T07:56:02.552-07:00",
      "updated_at": "2025-03-19T07:56:11.660-07:00"
    },
    "relationships": {
      "users": {
        "data": []
      }
    }
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

Response

200

application/vnd.api+json

team deleted

data

object

required

data.id

string

required

Unique ID of the team

data.type

enum<string>

required

Available options:

groups

data.attributes

object

required

data.attributes.name

string

required

The name of the team

data.attributes.created_at

string

required

Date of creation

data.attributes.updated_at

string

required

Date of last update

data.attributes.slug

string

data.attributes.description

string | null

The description of the team

data.attributes.notify_emails

string[] | null

Emails to attach to the team

data.attributes.color

string | null

The hex color of the team

data.attributes.position

integer | null

Position of the team

data.attributes.backstage_id

string | null

The Backstage entity id associated to this team. eg: :namespace/:kind/:entity_name

data.attributes.external_id

string | null

The external id associated to this team

data.attributes.pagerduty_id

string | null

The PagerDuty group id associated to this team

data.attributes.pagerduty_service_id

string | null

The PagerDuty service id associated to this team

data.attributes.opsgenie_id

string | null

The Opsgenie group id associated to this team

data.attributes.victor_ops_id

string | null

The VictorOps group id associated to this team

data.attributes.pagertree_id

string | null

The PagerTree group id associated to this team

data.attributes.cortex_id

string | null

The Cortex group id associated to this team

data.attributes.service_now_ci_sys_id

string | null

The Service Now CI sys id associated to this team

data.attributes.user_ids

integer[] | null

The user ids of the members of this team.

data.attributes.admin_ids

integer[] | null

The user ids of the admins of this team. These users must also be present in user_ids attribute.

data.attributes.alerts_email_enabled

boolean | null

Enable alerts through email

data.attributes.alerts_email_address

string | null

Email generated to send alerts to

data.attributes.alert_urgency_id

string | null

The alert urgency id of the team

data.attributes.slack_channels

object[] | null

Slack Channels associated with this team

data.attributes.slack_aliases

object[] | null

Slack Aliases associated with this team

Was this page helpful?

Get team incidents chartGet team incidents chart

curl --request DELETE \
  --url https://api.rootly.com/v1/teams/{id} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "id": "da788f78-edd9-4ed4-9c0f-1257e7495989",
    "type": "groups",
    "attributes": {
      "slug": "sapiente-error-harum-quia",
      "name": "Sapiente error harum quia.",
      "description": null,
      "color": "#D7F5E1",
      "position": 1,
      "notify_emails": [],
      "slack_channels": [],
      "slack_aliases": [],
      "pagerduty_id": null,
      "pagerduty_service_id": null,
      "backstage_id": null,
      "external_id": null,
      "opsgenie_id": null,
      "victor_ops_id": null,
      "pagertree_id": null,
      "cortex_id": null,
      "service_now_ci_sys_id": null,
      "user_ids": [],
      "admin_ids": [],
      "incidents_count": 1,
      "alert_urgency_id": null,
      "alerts_email_enabled": false,
      "alerts_email_address": "group-72ef3dd12b6728e442e9ae739c3db375@email.rootly.com",
      "created_at": "2025-03-19T07:56:02.552-07:00",
      "updated_at": "2025-03-19T07:56:11.660-07:00"
    },
    "relationships": {
      "users": {
        "data": []
      }
    }
  }
}

Overview

AlertEvents

AlertGroups

AlertRoutingRules

AlertUrgencies

AlertSources

Alerts

Audits

Authorizations

CatalogEntities

CatalogEntityProperties

CatalogFields

Catalogs

Causes

[DEPRECATED] CustomFieldOptions

[DEPRECATED] CustomFields

CustomForms

DashboardPanels

Dashboards

Environments

EscalationPolicies

EscalationLevelsPolicies

EscalationLevelsPath

EscalationLevels

EscalationPaths

FormFieldOptions

FormFieldPlacementConditions

FormFieldPlacements

FormFieldPositions

FormFields

FormSetConditions

FormSets

Functionalities

WorkflowTasks

[DEPRECATED] WorkflowCustomFieldSelections

WorkflowFormFieldConditions

WorkflowGroups

WorkflowRuns

Workflows

Heartbeats

IncidentActionItems

[DEPRECATED] IncidentCustomFieldSelections

IncidentEventFunctionalities

IncidentEventServices

IncidentEvents

IncidentFeedbacks

IncidentFormFieldSelections

IncidentPermissionSetBooleans

IncidentPermissionSetResources

IncidentPermissionSets

IncidentRetrospectives

IncidentRetrospectiveSteps

IncidentRoleTasks

IncidentRoles

IncidentStatusPageEvents

IncidentSubStatuses

IncidentTypes

Incidents

IpRanges

LiveCallRouters

OnCallRoles

OnCallShadows

OverrideShifts

PlaybookTasks

Playbooks

RetrospectiveTemplates

Pulses

RetrospectiveConfigurations

RetrospectiveProcessGroupSteps

RetrospectiveProcessGroups

RetrospectiveProcesses

RetrospectiveSteps

Roles

ScheduleRotationActiveDays

ScheduleRotationUsers

ScheduleRotations

Schedules

Shifts

Secrets

Services