Retrieves a specific team by id
curl --request GET \
--url https://api.rootly.com/v1/teams/{id} \
--header 'Authorization: Bearer <token>'{
"data": {
"id": "cdfe9a53-4417-4d77-a7d6-e1d77c4f9bc3",
"type": "groups",
"attributes": {
"slug": "qui-et-totam-ut",
"name": "Qui et totam 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-08T20:54:18.156-08:00",
"updated_at": "2025-12-08T20:54:18.156-08:00"
},
"relationships": {
"users": {
"data": []
}
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Team UUID
comma separated if needed. eg: users
users team found by slug
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 GET \
--url https://api.rootly.com/v1/teams/{id} \
--header 'Authorization: Bearer <token>'{
"data": {
"id": "cdfe9a53-4417-4d77-a7d6-e1d77c4f9bc3",
"type": "groups",
"attributes": {
"slug": "qui-et-totam-ut",
"name": "Qui et totam 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-08T20:54:18.156-08:00",
"updated_at": "2025-12-08T20:54:18.156-08:00"
},
"relationships": {
"users": {
"data": []
}
}
}
}