List all teams

Returns a list of all teams in the workspace with their members.

What are Teams? Teams group employees together to simplify project access management and form the basis for structured evaluations. Instead of assigning permissions to each employee individually, you can grant entire teams access to specific projects or areas. This makes it easier to manage rights, responsibilities, and resources in one place.

Teams are also used for:

Filtering charts and dashboards by team
Organizing employees into logical groups
Project access management
Team-based reporting and insights

What is returned:

Team identification (ID, name, icon)
Number of users in the team
Complete list of team members with their details (ID, name, avatar)

Note: This endpoint requires the Teams.manage permission.

GET/teams

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Responses

200List of teams

Array of TeamResponseDto

iconstringrequired

Emoji icon used for visual identification of the team. This icon appears next to the team name in lists and can be used to quickly identify teams. Common examples include: "🧑‍🤝‍🧑" (people holding hands), "💻" (laptop), "🎨" (artist palette).

idstringrequired

Unique identifier for the team (UUID format). Use this ID to reference the team in update, delete, or project assignment operations.

namestringrequired

The display name of the team. This name appears in team lists, project assignments, and throughout the application.

usersTeamUserDto[]required

Complete list of all users who are members of this team. Each user object includes their ID, name, and avatar information. Use the user IDs from this array when you need to reference team members.

Show properties

Array of TeamUserDto

avatarIdobject | nullrequired

Unique identifier for the user avatar image file (UUID format). This ID can be used to retrieve the avatar image through the file API. Null if the user has not uploaded an avatar.

firstNamestringrequired

The user first name as stored in their employee profile.

idstringrequired

Unique identifier for the user (UUID format). Use this ID when assigning users to teams or referencing team members.

lastNamestringrequired

The user last name as stored in their employee profile.

usersCountnumberrequired

Total number of users currently assigned to the team. This count matches the length of the users array and is provided for convenience.

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

curl -X GET "https://leadtime.app/api/public/teams" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/teams", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/teams",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

[
  {
    "icon": "🧑‍🤝‍🧑",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Development Team",
    "users": [
      {
        "avatarId": "123e4567-e89b-12d3-a456-426614174001",
        "firstName": "John",
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "lastName": "Doe"
      }
    ],
    "usersCount": 5
  }
]