Get team details

Returns full details of a specific team including all members.

What is returned:

Team identification (ID, name, icon emoji)
Number of users in the team
Complete list of all team members with:
- User ID
- First and last name
- Avatar file ID (if available)

Use cases:

Displaying team information in a detail view
Verifying team membership before making changes
Getting complete team data for editing

Note: Returns 404 if the team does not exist or has been deleted. This endpoint requires the Teams.manage permission.

GET/teams/{id}

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idstringrequired

Responses

200Team details

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/string" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

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

import requests

response = requests.get(
    "https://leadtime.app/api/public/teams/string",
    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
}