DELETE
/
v1
/
teams
/
{id}
Delete a team
curl --request DELETE \
  --url https://api.rootly.com/v1/teams/{id} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "id": "874c1a77-78eb-41e1-b3a4-3fbad51db073",
    "type": "groups",
    "attributes": {
      "slug": "error-et-eos-eius",
      "name": "Error et eos eius.",
      "description": null,
      "color": "#F5D9C4",
      "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-afad3e522471248c9ddad8d97daa8ddb@email.rootly.com",
      "alert_broadcast_enabled": false,
      "alert_broadcast_channel": {},
      "incident_broadcast_enabled": false,
      "incident_broadcast_channel": {},
      "created_at": "2025-08-21T23:36:32.707-07:00",
      "updated_at": "2025-08-21T23:36:39.276-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

id
required

Team UUID

Response

200
application/vnd.api+json

team deleted

The response is of type object.