Providers
Microsoft Teams
List teams
Get a list of teams belonging to the Microsoft Entra tenant. By default, archived and private channels are excluded from the results.
get/v1/providers/ms-teams/{channel_id}/teams
Path parameters
channel_idstring required
The ID of the Knock Microsoft Teams channel to get teams for.
Query parameters
ms_teams_tenant_objectstring required
A JSON encoded string containing the Microsoft Teams tenant object reference.
query_options.$filterstring
OData param passed to the Microsoft Graph API to filter teams.
query_options.$selectstring
OData param passed to the Microsoft Graph API to select fields on a team.
query_options.$topinteger
OData param passed to the Microsoft Graph API to limit the number of teams returned.
query_options.$skiptokenstring
OData param passed to the Microsoft Graph API to retrieve the next page of results.
Response
OK
Example response
{
"ms_teams_teams": [
{
"displayName": "Engineering Team",
"id": "team-id-1"
}
],
"skip_token": "token-for-next-page"
}