Teams
Update team brand colour
Set the colour shown behind a team's initials.
PUT /teams/{teamId}/brand-color
Sets the team's accent colour. It appears behind the team's initials anywhere the team has no logo, such as the team switcher and the top bar.
Authentication: Bearer token · Permission:
teams:write · Team permission:team_settings.write · Rate limit: default (120 / 60s)This is not the colour your clients see. Client-facing colour is set per client, and that is what appears on client dashboards and briefings. The team colour is internal and never reaches client-facing output.
Path parameters
teamId
string · uuid v7 required
The ID of the team whose colour is being set.
Request body
brandColor
string | null required
A hex colour as
#rrggbb, case-insensitive and stored lower case. Send null to clear it and fall back to the default.{ "brandColor": "#16a34a" }
The team's initials are drawn in white on this colour, so a pale value makes them hard to read. The settings page offers a fixed set of colours that all clear contrast against white; the API does not restrict you to them.
Request
curl -X PUT https://api.twominutereports.com/v1/teams/0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/brand-color \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"brandColor": "#16a34a"}'
Response
{
"success": true,
"data": { "brandColor": "#16a34a" }
}
{
"success": false,
"error": { "code": "VALIDATION_FAILED", "message": "Use a hex value like #2563eb" }
}
{
"success": false,
"error": { "code": "NOT_FOUND", "message": "Team not found" }
}