v1

latestOpenAPI 3.1.1Productboard Proprietary2026-07-2453178243.2 KB

teams

List teams

Retrieves a paginated list of teams from your workspace. Teams represent groups of members that can be used for organizing work and assigning ownership.

Teams are sorted by creation date, newest first.
Use the name parameter to filter by name (case-insensitive exact match).
Use the handle parameter to filter by handle (case-insensitive exact match).
Use the query parameter to search by partial name or handle (case-insensitive). For example, query=product will match "Product Team", "My Product", "production", etc.
Use the pageCursor parameter to paginate through results.

get/teams

Query parameters

pageCursorstring

Cursor for pagination.

namestring

Filter teams by name (case-insensitive exact match).

handlestring

Filter teams by handle (case-insensitive exact match).

querystring

Full-text search query. Performs case-insensitive partial match on team name and handle.

Response

A paginated list of teams

Example response

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "type": "team",
      "links": {
        "self": "https://api.productboard.com/v2/teams/123e4567-e89b-12d3-a456-426614174000",
        "members": "https://api.productboard.com/v2/teams/123e4567-e89b-12d3-a456-426614174000/members",
        "html": "https://example.productboard.com/settings/teams/12"
      },
      "fields": {
        "name": "Product Team",
        "handle": "productteam",
        "description": "Team responsible for product development",
        "avatarUrl": "https://cdn.productboard.com/teams/avatars/123/medium.png"
      },
      "createdAt": "2025-01-01T10:00:00Z",
      "updatedAt": "2025-01-15T14:30:00Z"
    }
  ]
}