Teams search

The teams search API lets you find, filter and analyze teams using flexible Typesense-powered queries. You can search by team name and filter by specific team properties.

Example use cases

Get all teams in the organization
{ "query_by": "*", "q": "*" }

Find teams by name

{
  "query_by": "*",
  "filter_by": "name:=engineering",
  "q": "*"
}

Search for teams by UID

{
  "query_by": "*",
  "filter_by": "teamUid:=THEMMQRBBHEPPQ",
  "q": "*"
}

Teams search response fields

Below are all the fields you may see in a team search result. Teams data is included by default.

Core fields

Field	Type	Description
id	string	Unique team identifier
uid	string	Unique team UID
name	string	Team name
description	string	Team description
icon	string	Team icon
color	string	Team color
identifier	string	Team identifier
organizationId	string	Organization ID
parentTeamId	string	Parent team ID (can be null)
teamOwnerId	string	Team owner ID
isActive	boolean	Whether the team is active
isPrivate	boolean	Whether the team is private
createdAt	string	Creation timestamp (ISO8601)
updatedAt	string	Last update timestamp (ISO8601)
deletedAt	string	Deletion timestamp (ISO8601)

Filtering options

You can filter teams using the filter_by parameter with Typesense syntax. The following filters are available:

Available filters

By team UID: teamUid:=THEMMQRBBHEPPQ
By name: name:=engineering

Combined filters

You can combine multiple filters using &&:

{
  "query_by": "*",
  "filter_by": "teamUid:=THEMMQRBBHEPPQ&&name:=engineering",
  "q": "*"
}

Filter examples

Find team by name only
{ "filter_by": "name:=engineering" }

Find team by UID only

{
  "filter_by": "teamUid:=THEMMQRBBHEPPQ"
}

API reference

MCP tools

Platform

Agent studio

Workflows

SLA

Apps platform

Help Center

Example use cases

Teams search response fields

Core fields

Filtering options

Available filters

Combined filters

Filter examples

​Example use cases

​Teams search response fields

​Core fields

​Filtering options

​Available filters

​Combined filters

​Filter examples

Example use cases

Teams search response fields

Core fields

Filtering options

Available filters

Combined filters

Filter examples