What is a Team?

A Team is a named group of members in your Productboard workspace. Teams can be defined around functional areas (marketing, design, leadership), cross-functional product teams, Scrum teams, squads — really any configuration of members you need.

Teams can be assigned to entities like features and initiatives, assigned objectives, granted access to saved views, or @mentioned in comments. This makes it easy to see what each team is working on and communicate in context.

When to use it

Org structure synchronization — Mirror your organization's team structure from your HR system or IdP into Productboard.
Team-based routing — Assign features or initiatives to teams programmatically based on product area or component ownership.
Capacity planning — Query teams and their assigned work to understand team load and allocation.
Automated onboarding — Add new members to the right teams when they join the workspace.
Team-level reporting — Build dashboards that show roadmap progress, feature counts, or feedback volume per team.

Key fields

Field	Description
`name`	Team display name (unique, 1-255 characters)
`handle`	Unique identifier used for @mentions (lowercase alphanumeric)
`description`	Optional description of the team's focus area (up to 10,000 characters)
`avatarUrl`	Team avatar image URL (read-only)
`createdAt`	When the team was created
`updatedAt`	When the team was last modified

Managing team membership

Update a team's members using PATCH /teams/{id} with these operations:

Operation	Description
`addItems`	Add members to the team (idempotent — adding existing members is a no-op)
`removeItems`	Remove specific members from the team
`set`	Replace the entire member list atomically
`clear`	Remove all members from the team

Related objects

Member — individual members within the team
Feature — features assigned to this team
Initiative — initiatives assigned to this team

Learn more

Organize members into teams