---
title: "Check auth"
method: GET
path: "/v1/providers/ms-teams/{channel_id}/auth_check"
tags: ["Providers", "Microsoft Teams"]
---

# Check auth

`GET /v1/providers/ms-teams/{channel_id}/auth_check`

## Request

- Base URL: `https://api.knock.app`
- URL: `https://api.knock.app/v1/providers/ms-teams/{channel_id}/auth_check`
- Auth: HTTP bearer

Check if a connection to Microsoft Teams has been authorized for a given Microsoft Teams tenant object.

## Path parameters

- `channel_id` string, required

## Query parameters

- `ms_teams_tenant_object` string, required

## Response `200`

OK

- MsTeamsAuthCheckResponse: The response from a Microsoft Teams auth check request.
  - `connection` object, required: A Microsoft Teams connection object.
    - `ms_teams_tenant_id` string, nullable: The Microsoft Teams tenant ID for the connected tenant.
    - `ok` boolean, required: Whether the Microsoft Teams connection is valid.
    - `reason` string, nullable: The reason for the Microsoft Teams connection if it is not valid.

## Changes

- **2026-07-14** `de4604427056`: 1 info
  - added the optional property `connection/ms_teams_tenant_id` to the response with the `200` status

[Operation history](https://skmtc.dev/knocklabs/apis/knock-api/changes/v1/providers/ms-teams/:channel_id/auth_check/get.md)

---

[API](https://skmtc.dev/knocklabs/apis/knock-api.md) · [All operations](https://skmtc.dev/knocklabs/apis/knock-api/llms.txt) · [OpenAPI document](https://skmtc.dev/knocklabs/apis/knock-api/revisions/dd3b76c7036d?raw)