Teams
Update team brand color
Set the color shown behind a team's initials.
PUT /teams/{teamId}/brand-color
Sets the team's accent color. 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 color your clients see. Client-facing color is set per client, and that is what appears on client dashboards and briefings. The team color is internal and never reaches client-facing output.
Path parameters
teamId
string · uuid v7 required
The ID of the team whose color is being set.
Request body
brandColor
string | null required
A hex color as
#rrggbb, case-insensitive and stored in 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 color, so a pale value makes them hard to read. The settings page offers a fixed set of colors that all have enough 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": "BAD_REQUEST", "message": "Validation error: Use a hex value like #2563eb at \"brandColor\"" }
}
{
"success": false,
"error": { "code": "NOT_FOUND", "message": "Team not found" }
}