# Teams

Teams are groups within your Featurebase organization. Use this endpoint to list and retrieve team information for conversation assignment and organization management.

## List all teams

 - [GET /v2/teams](https://docs.featurebase.app/rest-api/teams/listteams.md): Returns all teams in your organization.

### Response Structure

The response includes:
- object - Always "list"
- data - Array of team objects

### Team Object

Each team includes:
- id - Unique team identifier
- name - Team display name
- color - Team color in hex format
- icon - Team icon (emoji, predefined, or external URL)
- members - Array of admin IDs who are members of this team

### Example Response

json
{
  "object": "list",
  "data": [
    {
      "object": "team",
      "id": "507f1f77bcf86cd799439011",
      "name": "Support Team",
      "color": "#3B82F6",
      "icon": {
        "value": "👥",
        "type": "emoji"
      },
      "members": ["5fef50c5e9458a0012f82456", "5fef50c5e9458a0012f82457"]
    }
  ]
}


### Version Availability

This endpoint is only available in API version 2026-01-01.nova and newer.

## Get team by ID

 - [GET /v2/teams/{id}](https://docs.featurebase.app/rest-api/teams/getteambyid.md): Retrieves a single team by its Featurebase ID.

### Path Parameters

- id - The Featurebase internal ID of the team (MongoDB ObjectId)

### Response

Returns a team object with:
- id - Unique team identifier
- name - Team display name
- color - Team color in hex format
- icon - Team icon (emoji, predefined, or external URL)
- members - Array of admin IDs who are members of this team

### Example Response

json
{
  "object": "team",
  "id": "507f1f77bcf86cd799439011",
  "name": "Support Team",
  "color": "#3B82F6",
  "icon": {
    "value": "👥",
    "type": "emoji"
  },
  "members": ["5fef50c5e9458a0012f82456", "5fef50c5e9458a0012f82457"]
}


### Error Responses

- 404 Not Found - Team with the specified ID does not exist

### Version Availability

This endpoint is only available in API version 2026-01-01.nova and newer.