Teams
List teams
List the teams the authenticated user belongs to.
GET /teams
Returns the teams the authenticated user is a member of, newest first. Each entry is a lightweight summary; use Get team for full details. Any member can call this — no specific role is required.
Authentication: Bearer token · Permission:
teams:read · Rate limit: default (120 / 60s)Request
curl https://api.twominutereports.com/v1/teams \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"success": true,
"data": [
{
"id": "0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
"name": "Acme Marketing",
"logoUrl": "https://cdn.twominutereports.com/tmr/team_logo/0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f-9f2c4b7e1a3d5c8f.png",
"brandColor": "#2563eb",
"timezone": "Asia/Kolkata",
"createdAt": "2026-01-12T08:15:00.000Z"
},
{
"id": "0190f8b1-2c3d-7e4f-9a5b-6c7d8e9f0a1b",
"name": null,
"logoUrl": null,
"brandColor": null,
"timezone": null,
"createdAt": "2025-11-03T14:20:00.000Z"
}
]
}
{
"success": false,
"error": { "code": "UNAUTHORIZED", "message": "Authentication required" }
}
The team summary object
id
string · uuid v7
Team identifier. Use it as
teamId in other team endpoints.name
string | null
The team's display name, or
null if unnamed.logoUrl
string | null
The team's own logo, or
null when it has none — render the team's initials in that case. This is not the client-facing logo shown on a client's dashboard; that one belongs to the client.brandColor
string | null
The team's brand colour as
#rrggbb, shown behind its initials when it has no logo, or null when unset. Internal identity only: a client's own brand colour is set per client and is what appears on client-facing output.timezone
string | null
The IANA zone the team works in, or
null when unset — read null as UTC. It times the team's daily schedule-failure summary, formats its query log sheet, and is what a query default set to follow the team inherits. Set it with Update team timezone. It does not affect when a schedule runs.createdAt
string
When the team was created.