Get Team Members
Retrieve a list of all members in a team.
Endpoint
GET /api/teams/{teamId}/users
Bearer token for authentication
Path Parameters
Query Parameters
Page number for pagination (default: 1)
Number of results per page
Search term to filter members by username
Response
Array of team member objects
Team user relationship UUID
Member role: team-member, team-view-only, or team-manager
ISO 8601 timestamp when user joined team
Example Request
curl https://your-umami-instance.com/api/teams/660e8400-e29b-41d4-a716-446655440001/users \
-H "Authorization: Bearer YOUR_TOKEN"
Example Response
{
"data": [
{
"id": "880e8400-e29b-41d4-a716-446655440003",
"userId": "990e8400-e29b-41d4-a716-446655440004",
"teamId": "660e8400-e29b-41d4-a716-446655440001",
"role": "team-manager",
"createdAt": "2024-01-10T08:00:00.000Z",
"user": {
"id": "990e8400-e29b-41d4-a716-446655440004",
"username": "john.doe"
}
},
{
"id": "aa0e8400-e29b-41d4-a716-446655440005",
"userId": "bb0e8400-e29b-41d4-a716-446655440006",
"teamId": "660e8400-e29b-41d4-a716-446655440001",
"role": "team-member",
"createdAt": "2024-01-15T12:00:00.000Z",
"user": {
"id": "bb0e8400-e29b-41d4-a716-446655440006",
"username": "jane.smith"
}
}
],
"count": 2,
"page": 1,
"pageSize": 20
}
Team Roles
Full permissions to manage team settings, members, and resources
Can view and edit team resources but cannot manage team settings or members
Read-only access to team resources
Error Responses
Unauthorized - You must be a member of this team
You must be a member of the team to view its member list. Members are ordered by their join date (oldest first).