Delete a specific team by id
curl --request DELETE \
--url https://api.rootly.com/v1/teams/{id} \
--header 'Authorization: Bearer <token>'{
"data": {
"id": "0076c444-abc7-4581-ad99-2ef1506f55c4",
"type": "groups",
"attributes": {
"slug": "enim-aliquam-sapiente-ut",
"name": "Enim aliquam sapiente ut.",
"description": null,
"color": "#D7E7F5",
"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": "[email protected]",
"alert_broadcast_enabled": false,
"alert_broadcast_channel": {},
"incident_broadcast_enabled": false,
"incident_broadcast_channel": {},
"auto_add_members_when_attached": false,
"created_at": "2025-12-09T10:05:44.812-08:00",
"updated_at": "2025-12-09T10:05:52.166-08:00"
},
"relationships": {
"users": {
"data": []
}
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Team UUID
team deleted
Show child attributes
Unique ID of the team
groups Show child attributes
The name of the team
Date of creation
Date of last update
The description of the team
Emails to attach to the team
The hex color of the team
Position of the team
The Backstage entity id associated to this team. eg: :namespace/:kind/:entity_name
The external id associated to this team
The PagerDuty group id associated to this team
The PagerDuty service id associated to this team
The Opsgenie group id associated to this team
The VictorOps group id associated to this team
The PagerTree group id associated to this team
The Cortex group id associated to this team
The Service Now CI sys id associated to this team
The user ids of the members of this team.
The user ids of the admins of this team. These users must also be present in user_ids attribute.
Enable alerts through email
Email generated to send alerts to
The alert urgency id of the team
Enable alerts to be broadcasted to a specific channel
Enable incidents to be broadcasted to a specific channel
Auto add members to incident channel when team is attached
Was this page helpful?
curl --request DELETE \
--url https://api.rootly.com/v1/teams/{id} \
--header 'Authorization: Bearer <token>'{
"data": {
"id": "0076c444-abc7-4581-ad99-2ef1506f55c4",
"type": "groups",
"attributes": {
"slug": "enim-aliquam-sapiente-ut",
"name": "Enim aliquam sapiente ut.",
"description": null,
"color": "#D7E7F5",
"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": "[email protected]",
"alert_broadcast_enabled": false,
"alert_broadcast_channel": {},
"incident_broadcast_enabled": false,
"incident_broadcast_channel": {},
"auto_add_members_when_attached": false,
"created_at": "2025-12-09T10:05:44.812-08:00",
"updated_at": "2025-12-09T10:05:52.166-08:00"
},
"relationships": {
"users": {
"data": []
}
}
}
}