Search teams

MCP tool: `search_teams`

Searches for teams using Thena’s powerful search API with advanced filtering capabilities. This tool allows you to find teams based on various criteria including name, team UID, and other team properties.

Example prompt

Search for teams with "we" in their name

Response fields

The response will contain a result object with the following structure:

Field	Type	Description
found	number	Total number of teams found
hits	array	Array of team objects matching the search criteria
page	number	Current page number
facet_counts	array	Facet counts for search results
request_params	object	Parameters used for the search request
search_cutoff	boolean	Whether the search was cut off due to limits

Team object fields

Each team in the hits array contains a document object with the following fields:

Field	Type	Description
id	string	Team unique identifier
name	string	Team name
icon	string	Team icon
color	string	Team color (RGB format)
identifier	string	Team identifier/code
description	string	Team description
teamOwner	string	Team owner name
teamOwnerId	string	Team owner ID
isActive	boolean	Whether the team is active
isPrivate	boolean	Whether the team is private
createdAt	string (ISO8601)	Team creation timestamp
updatedAt	string (ISO8601)	Last update timestamp
ticketTypes	array	Available ticket types for this team
tags	array	Team tags
priorities	array	Available ticket priorities
sentiments	array	Available ticket sentiments
statuses	array	Available ticket statuses
forms	array	Team forms
subTeams	array	Sub-teams
ticketFields	array	Custom ticket fields
isDefaultTeam	boolean	Whether this is the default team
ticketSources	array	Available ticket sources

Nested object fields

Ticket Types:

id: Ticket type ID
name: Ticket type name
icon: Ticket type icon
color: Ticket type color
autoAssign: Whether tickets auto-assign

Priorities:

id: Priority ID
name: Priority name
description: Priority description
isDefault: Whether this is the default priority

Sentiments:

id: Sentiment ID
name: Sentiment name
isDefault: Whether this is the default sentiment

Statuses:

id: Status ID
name: Status name
description: Status description
isDefault: Whether this is the default status

Forms:

id: Form ID
name: Form name
description: Form description
fields: Array of form fields

Ticket Sources:

label: Source label
value: Source value

Sample response

{
  "result": {
    "found": 1,
    "hits": [
      {
        "document": {
          "id": "THETT4QZZD9PPM",
          "name": "wed",
          "icon": "",
          "color": "rgb(155, 135, 245)",
          "identifier": "WED",
          "description": null,
          "teamOwner": "shakthi+1",
          "teamOwnerId": "UTH00SEXXFNVVN",
          "isActive": true,
          "isPrivate": false,
          "createdAt": "2025-07-09T09:17:14.954Z",
          "updatedAt": "2025-07-09T09:17:14.954Z",
          "ticketTypes": [
            {
              "id": "9W5K7QZJ10DG45E7T1FJHHF2MM32P",
              "name": "Bug",
              "icon": "",
              "color": "#db1f61",
              "autoAssign": true
            },
            {
              "id": "MW5K7QZJ106FT03R2JKSBDD9DTGQZ",
              "name": "Feature Request",
              "icon": "",
              "color": "#1f74db",
              "autoAssign": true
            },
            {
              "id": "MW5K7QZJ1068644FX44KR04C6801D",
              "name": "Question",
              "icon": "",
              "color": "#1fdb8a",
              "autoAssign": true
            },
            {
              "id": "MW5K7QZJ10QHFEJQWXBJHYPG146C3",
              "name": "Task",
              "icon": "",
              "color": "#db7a1f",
              "autoAssign": true
            }
          ],
          "tags": [],
          "priorities": [
            {
              "id": "WQ5K7QZJ102C4JKG6XE01M2G3HEAQ",
              "name": "Low",
              "description": "Low priority tickets.",
              "isDefault": false
            },
            {
              "id": "GR5K7QZJ10H0300NBSAPN5CG4TN9F",
              "name": "Medium",
              "description": "Medium priority tickets.",
              "isDefault": true
            },
            {
              "id": "GR5K7QZJ105KWTPW1AG052HBVAPNF",
              "name": "High",
              "description": "High priority tickets.",
              "isDefault": false
            },
            {
              "id": "GR5K7QZJ10RPP1CQV6KG57SM7M75E",
              "name": "Urgent",
              "description": "Urgent priority tickets.",
              "isDefault": false
            }
          ],
          "sentiments": [
            {
              "id": "4T5K7QZJ10MR5QR6KZZ43M5G3YKPH",
              "name": "Positive",
              "isDefault": false
            },
            {
              "id": "JT5K7QZJ1047VQT6M06TMANM3D9TQ",
              "name": "Negative",
              "isDefault": false
            },
            {
              "id": "JT5K7QZJ107BR5DAKC2HBC4G3NA5A",
              "name": "Neutral",
              "isDefault": true
            }
          ],
          "statuses": [
            {
              "id": "TN5K7QZJ10AXB995EXD07ZSXBYPM4",
              "name": "In progress",
              "description": "Tickets that are currently in progress and being worked on.",
              "isDefault": false
            },
            {
              "id": "VN5K7QZJ10CJK5E47S8TQSA19XCXA",
              "name": "On hold",
              "description": "Tickets that are currently on hold.",
              "isDefault": false
            },
            {
              "id": "VN5K7QZJ1042MM6W6DF59ZZAK5DTP",
              "name": "Closed",
              "description": "Tickets that are closed or resolved.",
              "isDefault": false
            },
            {
              "id": "YM5K7QZJ10NPP6GZXZTR1C2DB9AG3",
              "name": "Open",
              "description": "Tickets that are open and awaiting prioritization.",
              "isDefault": true
            }
          ],
          "forms": [
            {
              "id": "FODDKPKKXW88L",
              "name": "Default team form",
              "description": "Default form for the team",
              "fields": [
                {
                  "field": "NMW047ZJ10RJHW0W5DB19SEM5W75A",
                  "fieldType": "thena_restricted",
                  "defaultValue": null,
                  "mandatoryOnClose": true,
                  "visibleToCustomer": true,
                  "editableByCustomer": true,
                  "mandatoryOnCreation": true
                },
                {
                  "field": "NMW047ZJ109W62PM4FR82YG58KXTN",
                  "fieldType": "thena_restricted",
                  "defaultValue": null,
                  "mandatoryOnClose": true,
                  "visibleToCustomer": true,
                  "editableByCustomer": true,
                  "mandatoryOnCreation": true
                },
                {
                  "field": "NMW047ZJ10D2JAMZRM4TGPMVYYG2K",
                  "fieldType": "thena_restricted",
                  "defaultValue": null,
                  "mandatoryOnClose": true,
                  "visibleToCustomer": true,
                  "editableByCustomer": true,
                  "mandatoryOnCreation": true
                }
              ]
            },
            {
              "id": "FOCCGUHH8GEE4",
              "name": "Default team escalation form",
              "description": "Default escalation form for the team",
              "fields": [
                {
                  "field": "3PW047ZJ105ENAGR1BT2NM5PG3ZM5",
                  "fieldType": "thena_restricted",
                  "defaultValue": null,
                  "mandatoryOnClose": false,
                  "visibleToCustomer": false,
                  "editableByCustomer": true,
                  "mandatoryOnCreation": true
                }
              ]
            }
          ],
          "subTeams": [],
          "ticketFields": [],
          "isDefaultTeam": true,
          "ticketSources": [
            {
              "label": "Api",
              "value": "api"
            },
            {
              "label": "Manual",
              "value": "manual"
            },
            {
              "label": "Web",
              "value": "web"
            }
          ]
        }
      }
    ],
    "page": 1,
    "facet_counts": [],
    "request_params": {
      "search_mode": "fallback",
      "q": "*",
      "query_by": "*",
      "filter_by": "name:=we"
    },
    "search_cutoff": false
  }
}

Notes

Only authorized users can access this tool; results are scoped to the user’s organization.
The search API supports full-text search on team names using ILike pattern matching.
Team UID searches require exact matches.
Filters can be combined using AND or OR logic for complex queries.
Boolean filters use true/false values.
The search is case-insensitive for text fields.
Results are paginated with a maximum of 250 items per page.
Use the range operator for date ranges (e.g., “[2024-01-01..2024-12-31]”).

API reference

MCP tools

Platform

Agent studio

Workflows

SLA

Apps platform

Help Center

MCP tool: `search_teams`

Example prompt

Response fields

Team object fields

Nested object fields

Sample response

Notes

API reference

MCP tools

Platform

Agent studio

Workflows

SLA

Apps platform

Help Center

Documentation Index

​MCP tool: search_teams

​Example prompt

​Response fields

​Team object fields

​Nested object fields

​Sample response

​Notes

MCP tool: `search_teams`

Example prompt

Response fields

Team object fields

Nested object fields

Sample response

Notes