List alert teams Beta
GET /api/v1/alerting/teams
Every alert team in your workspace, sorted by name. A team is a named group of workspace members and contacts.
Needs an X-API-Key header whose owner has access to uptime monitoring in the app. The call counts once against your daily quota. See Monitoring API: getting started for authentication, rate limits and errors.
Request
Response
200 · application/json
- {
- "total": 1,
- "teams": [
- { "id": "tm_2c7e91a4b6d0f3e85a17", "name": "Support", "userIds": [42, 57],
- "users": [{ "id": 42, "name": "Sam Taylor", "email": "[email protected]" }, …],
- "contactIds": ["ct_5b8d1f0a9c2e4d6f7a83"],
- "contacts": [{ "id": "ct_5b8d1f0a9c2e4d6f7a83", "name": "Night shift" }],
- "createdAt": "2026-09-17T09:10:40.000Z", "updatedAt": "2026-09-17T09:10:40.000Z" }
- ],
- "usage": { "used": 48, "dailyLimit": 100, "tier": "free" }
- }
The whole list comes back in one response; there is no paging. See the team object for every field.
Errors
| Status | When |
|---|---|
401 | The API key is missing or invalid. |
403 | The key's owner doesn't have access to uptime monitoring, or the key isn't linked to a workspace. |
405 | The endpoint doesn't accept that method. |
429 | A rate limit or your daily quota was hit. Read Retry-After, in seconds. |
500, 503 | Something went wrong, or the API is temporarily unavailable. Try again. |
Errors are JSON: { "error": "message" }. See Monitoring API errors.
Related
- Create a team: group people together
- List contacts: the people you can add